API Reference google_api_apigee v0.20.0
Modules
API client metadata for GoogleApi.Apigee.V1.
API calls for all endpoints tagged Hybrid
.
API calls for all endpoints tagged Organizations
.
API calls for all endpoints tagged Projects
.
Handle Tesla connections for GoogleApi.Apigee.V1.
Message that represents an arbitrary HTTP body. It should only be used for payload formats that can't be represented as JSON, such as raw binary or an HTML page. This message can be used both in streaming and non-streaming API methods in the request as well as the response. It can be used as a top-level request field, which is convenient if one wants to extract parameters from either the URL or HTTP template into the request fields and also want access to the raw HTTP body. Example: message GetResourceRequest { // A unique request id. string request_id = 1; // The raw HTTP body is bound to this field. google.api.HttpBody http_body = 2; } service ResourceService { rpc GetResource(GetResourceRequest) returns (google.api.HttpBody); rpc UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty); } Example with streaming methods: service CaldavService { rpc GetCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); rpc UpdateCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); } Use of this type only changes how the request and response bodies are handled, all other features will continue to work unchanged.
Attributes
-
Get
(type:GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1AccessGet.t
, default:nil
) - -
Remove
(type:GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1AccessRemove.t
, default:nil
) - -
Set
(type:GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1AccessSet.t
, default:nil
) -
Get action. For example, "Get" : { "name" : "target.name", "value" : "default" }
Remove action. For example, "Remove" : { "name" : "target.name", "success" : true }
Set action. For example, "Set" : { "name" : "target.name", "success" : true, "value" : "default" }
A reference to a certificate or key, certificate pair.
Attributes
-
location
(type:String.t
, default:nil
) - Location of the alias file. For example, a Google Cloud Storage URI. -
name
(type:String.t
, default:nil
) - Name of the alias revision included in the keystore in the following format:organizations/{org}/environments/{env}/keystores/{keystore}/aliases/{alias}/revisions/{rev}
-
type
(type:String.t
, default:nil
) -
the Api category resource wrapped with response status, error_code etc.
the Api category resource.
Attributes
-
apiResources
(type:list(String.t)
, default:nil
) - Comma-separated list of API resources to be bundled in the API Product. By default, the resource paths are mapped from theproxy.pathsuffix
variable. The proxy path suffix is defined as the URI fragment following the ProxyEndpoint base path. For example, if theapiResources
element is defined to be/forecastrss
and the base path defined for the API proxy is/weather
, then only requests to/weather/forecastrss
are permitted by the API product. You can select a specific path, or you can select all subpaths with the following wildcard: - /: Indicates that all sub-URIs are included. - /* : Indicates that only URIs one level down are included. By default, / supports the same resources as / as well as the base path defined by the API proxy. For example, if the base path of the API proxy is/v1/weatherapikey
, then the API product supports requests to/v1/weatherapikey
and to any sub-URIs, such as/v1/weatherapikey/forecastrss
,/v1/weatherapikey/region/CA
, and so on. For more information, see: - Manage API products - Managing a transaction recording policy using the API -
approvalType
(type:String.t
, default:nil
) - Specifies how API keys are approved to access the APIs defined by the API product. If set tomanual
, the consumer key is generated and returned in "pending" state. In this case, the API keys won't work until they have been explicitly approved. If set toauto
, the consumer key is generated and returned in "approved" state and can be used immediately. NOTE: Typically,auto
is used to provide access to free or trial API products that provide limited quota or capabilities. -
attributes
(type:list(GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1Attribute.t)
, default:nil
) - Array of attributes that may be used to extend the default API product profile with customer-specific metadata. You can specify a maximum of 18 attributes. Use this property to specify the access level of the API product as eitherpublic
,private
, orinternal
. Only products markedpublic
are available to developers in the Apigee developer portal. For example, you can set a product tointernal
while it is in development and then change access topublic
when it is ready to release on the portal. API products marked asprivate
do not appear on the portal but can be accessed by external developers. For monetization, you can use the attributes field to: - Specify transaction success criteria - Specify custom attributes on which you base rate plan charges. -
createdAt
(type:String.t
, default:nil
) - Response only. Creation time of this environment as milliseconds since epoch. -
description
(type:String.t
, default:nil
) - An overview of the API product. Include key information about the API product that is not captured by other fields. -
displayName
(type:String.t
, default:nil
) - The name to be displayed in the UI or developer portal to developers registering for API access. -
environments
(type:list(String.t)
, default:nil
) - A comma-separated list of environment names to which the API product is bound. Requests to environments that are not listed are rejected. By specifying one or more environments, you can bind the resources listed in the API product to a specific environment, preventing developers from accessing those resources through API proxies deployed in another environment. This setting is used, for example, to prevent resources associated with API proxies in 'prod' from being accessed by API proxies deployed in 'test'. -
lastModifiedAt
(type:String.t
, default:nil
) - Response only. Modified time of this environment as milliseconds since epoch. -
name
(type:String.t
, default:nil
) - The internal name of the API Product. Characters you can use in the name are restricted to: A-Z0-9._-$ %. NOTE: The internal name cannot be edited when updating the API product. -
operationGroup
(type:GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1OperationGroup.t
, default:nil
) - The operation_group enables api product creators to group Apigee proxies or remote services with resources, method types and quotas. The resource refers to the resource URI(excluding the base path). With this grouping, API product creator is able to finetune and give precise control over which REST methods have access to which resources, and how many such calls can be made (via Quota). Note that api_resources cannot be specified at both the API product level as well as within the operation_group. If configured that way, the call will fail. Please refer go/api-product-with-methods for additional details. -
proxies
(type:list(String.t)
, default:nil
) - A comma-separated list of API proxy names to which this API product is bound. By specifying API proxies, you can associate resources in the API product with specific API proxies, preventing developers from accessing those resources through other API proxies. Edge rejects requests to API proxies that are not listed. NOTE: The API proxy names must already exist in the specified environment as they will be validated upon creation. -
quota
(type:String.t
, default:nil
) - The number of request messages permitted per app by this API product for the specifiedquotaInterval
andquotaTimeUnit
. For example, aquota
of 50, for aquotaInterval
of 12 and aquotaTimeUnit
of hours means 50 requests are allowed every 12 hours. -
quotaInterval
(type:String.t
, default:nil
) - The time interval over which the number of request messages is calculated. -
quotaTimeUnit
(type:String.t
, default:nil
) - The time unit defined for thequotaInterval
. Valid values include minute, hour, day, or month. -
scopes
(type:list(String.t)
, default:nil
) - A comma-separated list of OAuth scopes that are validated at runtime. Edge validates that the scopes in any access token presented match the scopes defined in the OAuth policy assoicated with the API product.
Metadata describing the API proxy
API proxy revision.
Attributes
-
errorCode
(type:String.t
, default:nil
) - ID that can be used to find errors in the log files. -
message
(type:String.t
, default:nil
) - Description of the operation. -
requestId
(type:String.t
, default:nil
) - ID that can be used to find request details in the log files. -
status
(type:String.t
, default:nil
) - Status of the operation.
Attributes
-
apiProducts
(type:list(GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1ApiProductRef.t)
, default:nil
) - List of API products associated with the app. -
appId
(type:String.t
, default:nil
) - ID of the app. -
attributes
(type:list(GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1Attribute.t)
, default:nil
) - List of attributes. -
callbackUrl
(type:String.t
, default:nil
) - Callback URL used by OAuth 2.0 authorization servers to communicate authorization codes back to apps. -
companyName
(type:String.t
, default:nil
) - Name of the company that owns the app. -
createdAt
(type:String.t
, default:nil
) - Output only. Unix time when the app was created. -
credentials
(type:list(GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1Credential.t)
, default:nil
) - Output only. Set of credentials for the app. Credentials are API key/secret pairs associated with API products. -
developerId
(type:String.t
, default:nil
) - ID of the developer. -
keyExpiresIn
(type:String.t
, default:nil
) - Duration, in milliseconds, of the consumer key that will be generated for the app. The default value, -1, indicates an infinite validity period. Once set, the expiration can't be updated. json key: keyExpiresIn -
lastModifiedAt
(type:String.t
, default:nil
) - Output only. Last modified time as milliseconds since epoch. -
name
(type:String.t
, default:nil
) - Name of the app. -
scopes
(type:list(String.t)
, default:nil
) - Scopes to apply to the app. The specified scope names must already exist on the API product that you associate with the app. -
status
(type:String.t
, default:nil
) - Status of the credential.
Attributes
-
created
(type:String.t
, default:nil
) - Creation time of the query. -
error
(type:String.t
, default:nil
) - Error is set when query fails. -
executionTime
(type:String.t
, default:nil
) - ExecutionTime is available only after the query is completed. -
name
(type:String.t
, default:nil
) - Asynchronous Query Name. -
queryParams
(type:GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1QueryMetadata.t
, default:nil
) - Contains information like metrics, dimenstions etc of the AsyncQuery. -
reportDefinitionId
(type:String.t
, default:nil
) - Asynchronous Report ID. -
result
(type:GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1AsyncQueryResult.t
, default:nil
) - Result is available only after the query is completed. -
resultFileSize
(type:String.t
, default:nil
) - ResultFileSize is available only after the query is completed. -
resultRows
(type:String.t
, default:nil
) - ResultRows is available only after the query is completed. -
self
(type:String.t
, default:nil
) - Self link of the query. Example:/organizations/myorg/environments/myenv/queries/9cfc0d85-0f30-46d6-ae6f-318d0cb961bd
-
state
(type:String.t
, default:nil
) - Query state could be "enqueued", "running", "completed", "failed". -
updated
(type:String.t
, default:nil
) - Last updated timestamp for the query.
Key-value pair to store extra metadata.
An X.509 certificate as defined in RFC 5280.
Version of the API proxy configuration schema. Currently, only 4.0 is supported.
Attributes
-
apiProducts
(type:list(GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1ApiProductRef.t)
, default:nil
) - List of API products this credential can be used for. -
attributes
(type:list(GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1Attribute.t)
, default:nil
) - List of attributes associated with this credential. -
consumerKey
(type:String.t
, default:nil
) - Consumer key. -
consumerSecret
(type:String.t
, default:nil
) - Secret key. -
expiresAt
(type:String.t
, default:nil
) - Time the credential will expire in milliseconds since epoch. -
issuedAt
(type:String.t
, default:nil
) - Time the credential was issued in milliseconds since epoch. -
scopes
(type:list(String.t)
, default:nil
) - List of scopes to apply to the app. Specified scopes must already exist on the API product that you associate with the app. -
status
(type:String.t
, default:nil
) - Status of the credential.
Attributes
-
chartType
(type:String.t
, default:nil
) - This field contains the chart type for the report -
comments
(type:list(String.t)
, default:nil
) - Legacy field: not used. This field contains a list of comments associated with custom report -
createdAt
(type:String.t
, default:nil
) - Output only. Unix time when the app was created json key: createdAt -
dimensions
(type:list(String.t)
, default:nil
) - This contains the list of dimensions for the report -
displayName
(type:String.t
, default:nil
) - This is the display name for the report -
environment
(type:String.t
, default:nil
) - Output only. Environment name -
filter
(type:String.t
, default:nil
) - This field contains the filter expression -
fromTime
(type:String.t
, default:nil
) - Legacy field: not used. Contains the from time for the report -
lastModifiedAt
(type:String.t
, default:nil
) - Output only. Modified time of this entity as milliseconds since epoch. json key: lastModifiedAt -
lastViewedAt
(type:String.t
, default:nil
) - Output only. Last viewed time of this entity as milliseconds since epoch -
limit
(type:String.t
, default:nil
) - Legacy field: not used This field contains the limit for the result retrieved -
metrics
(type:list(GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1CustomReportMetric.t)
, default:nil
) - Required. This contains the list of metrics -
name
(type:String.t
, default:nil
) - Required. Unique identifier for the report T his is a legacy field used to encode custom report unique id -
offset
(type:String.t
, default:nil
) - Legacy field: not used. This field contains the offset for the data -
organization
(type:String.t
, default:nil
) - Output only. Organization name -
properties
(type:list(GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1ReportProperty.t)
, default:nil
) - This field contains report properties such as ui metadata etc. -
sortByCols
(type:list(String.t)
, default:nil
) - Legacy field: not used much. Contains the list of sort by columns -
sortOrder
(type:String.t
, default:nil
) - Legacy field: not used much. Contains the sort order for the sort columns -
tags
(type:list(String.t)
, default:nil
) - Legacy field: not used. This field contains a list of tags associated with custom report -
timeUnit
(type:String.t
, default:nil
) - This field contains the time unit of aggregation for the report -
toTime
(type:String.t
, default:nil
) - Legacy field: not used. Contains the end time for the report -
topk
(type:String.t
, default:nil
) - Legacy field: not used. This field contains the top k parameter value for restricting the result
This encapsulates a metric property of the form sum(message_count) where name is message_count and function is sum
Data collector and its configuration.
The data store defines the connection to export data repository (Cloud Storage, BigQuery), including the credentials used to access the data repository.
Configuration detail for datastore
Date range of the data to export.
Attributes
-
faultJSONPaths
(type:list(String.t)
, default:nil
) - List of JSON paths that specify the JSON elements to be filtered from JSON payloads in error flows. -
faultXPaths
(type:list(String.t)
, default:nil
) - List of XPaths that specify the XML elements to be filtered from XML payloads in error flows. -
name
(type:String.t
, default:nil
) - Name of the debug mask. -
namespaces
(type:map()
, default:nil
) - Map of namespaces to URIs. -
requestJSONPaths
(type:list(String.t)
, default:nil
) - List of JSON paths that specify the JSON elements to be filtered from JSON request message payloads. -
requestXPaths
(type:list(String.t)
, default:nil
) - List of XPaths that specify the XML elements to be filtered from XML request message payloads. -
responseJSONPaths
(type:list(String.t)
, default:nil
) - List of JSON paths that specify the JSON elements to be filtered from JSON response message payloads. -
responseXPaths
(type:list(String.t)
, default:nil
) - List of XPaths that specify the XML elements to be filtered from XML response message payloads. -
variables
(type:list(String.t)
, default:nil
) - List of variables that should be masked from the debug output.
Attributes
-
count
(type:integer()
, default:nil
) - Optional. The number of request to be traced. Min = 1, Max = 15, Default = 10. -
filter
(type:String.t
, default:nil
) - Optional. A conditional statement which is evaluated against the request message to determine if it should be traced. Syntax matches that of on API Proxy bundle flow Condition. -
name
(type:String.t
, default:nil
) - A unique ID for this DebugSession. -
timeout
(type:String.t
, default:nil
) - Optional. The time in seconds after which this DebugSession should end. This value will override the value in query param, if both are provided. -
tracesize
(type:integer()
, default:nil
) - Optional. The maximum number of bytes captured from the response payload. Min = 0, Max = 5120, Default = 5120. -
validity
(type:integer()
, default:nil
) - Optional. The length of time, in seconds, that this debug session is valid, starting from when it's received in the control plane. Min = 1, Max = 15, Default = 10.
A transaction contains all of the debug information of the entire message flow of an API call processed by the runtime plane. The information is collected and recorded at critical points of the message flow in the runtime apiproxy.
Attributes
-
apiProxy
(type:String.t
, default:nil
) - API proxy. -
deployStartTime
(type:String.t
, default:nil
) - Time the API proxy was markeddeployed
in the control plane in millisconds since epoch. -
environment
(type:String.t
, default:nil
) - Environment. -
errors
(type:list(GoogleApi.Apigee.V1.Model.GoogleRpcStatus.t)
, default:nil
) - Errors reported for this deployment. Populated only when state == ERROR. This field is not populated in List APIs. -
instances
(type:list(GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1InstanceDeploymentStatus.t)
, default:nil
) - Status reported by each runtime instance. This field is not populated in List APIs. -
pods
(type:list(GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1PodStatus.t)
, default:nil
) - Status reported by runtime pods. This field is not populated for List APIs. -
revision
(type:String.t
, default:nil
) - API proxy revision. -
routeConflicts
(type:list(GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1DeploymentChangeReportRoutingConflict.t)
, default:nil
) - Conflicts in the desired state routing configuration. The presence of conflicts does not cause the state to be ERROR, but it will mean that some of the deployments basepaths are not routed to its environment. If the conflicts change, the state will transition to PROGRESSING until the latest configuration is rolled out to all instances. This field is not populated in List APIs. -
state
(type:String.t
, default:nil
) - Current state of the deployment. This field is not populated in List APIs.
Response for GenerateDeployChangeReport and GenerateUndeployChangeReport. This report contains any validation failures that would cause the deployment to be rejected, as well changes and conflicts in routing that may occur due to the new deployment. The existence of a routing warning does not necessarily imply that the deployment request is bad, if the desired state of the deployment request is to effect a routing change. The primary purposes of the routing messages are: 1) To inform users of routing changes that may have an effect on traffic currently being routed to other existing deployments. 2) To warn users if some basepath in the proxy will not receive traffic due to an existing deployment having already claimed that basepath. The presence of routing conflicts/changes will not cause non-dry-run DeployApiProxy/UndeployApiProxy requests to be rejected.
Describes a potential routing change that may occur as a result of some deployment operation.
Describes a routing conflict that may cause a deployment not to receive traffic at some basepath.
A tuple representing a basepath and the deployment containing it.
Attributes
-
attributes
(type:map()
, default:nil
) - Additional key-value metadata for the deployment. -
basePath
(type:String.t
, default:nil
) - Base path where the application will be hosted. Defaults to "/". -
location
(type:String.t
, default:nil
) - Location of the API proxy bundle as a URI. -
name
(type:String.t
, default:nil
) - Name of the API or shared flow revision to be deployed in the following format:organizations/{org}/apis/{api}/revisions/{rev}
ororganizations/{org}/sharedflows/{sharedflow}/revisions/{rev}
-
proxyUid
(type:String.t
, default:nil
) - Unique ID of the API proxy revision. -
uid
(type:String.t
, default:nil
) - Unique ID. The ID will only change if the deployment is deleted and recreated.
Attributes
-
accessType
(type:String.t
, default:nil
) - Access type. -
appFamily
(type:String.t
, default:nil
) - Developer app family. -
apps
(type:list(String.t)
, default:nil
) - List of apps associated with the developer. -
attributes
(type:list(GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1Attribute.t)
, default:nil
) - Optional. Developer attributes (name/value pairs). The custom attribute limit is 18. -
companies
(type:list(String.t)
, default:nil
) - List of companies associated with the developer. -
createdAt
(type:String.t
, default:nil
) - Output only. Time at which the developer was created in milliseconds since epoch. -
developerId
(type:String.t
, default:nil
) - ID of the developer. Note: IDs are generated internally by Apigee and are not guaranteed to stay the same over time. -
email
(type:String.t
, default:nil
) - Required. Email address of the developer. This value is used to uniquely identify the developer in Apigee hybrid. -
firstName
(type:String.t
, default:nil
) - Required. First name of the developer. -
lastModifiedAt
(type:String.t
, default:nil
) - Output only. Time at which the developer was last modified in milliseconds since epoch. -
lastName
(type:String.t
, default:nil
) - Required. Last name of the developer. -
organizationName
(type:String.t
, default:nil
) - Output only. Name of the Apigee organization in which the developer resides. -
status
(type:String.t
, default:nil
) - Output only. Status of the developer. Valid values areactive
andinactive
. -
userName
(type:String.t
, default:nil
) - Required. User name of the developer. Not used by Apigee hybrid.
Attributes
-
apiProducts
(type:list(String.t)
, default:nil
) - List of API products associated with the developer app. -
appFamily
(type:String.t
, default:nil
) - Developer app family. -
appId
(type:String.t
, default:nil
) - ID of the developer app. -
attributes
(type:list(GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1Attribute.t)
, default:nil
) - List of attributes for the developer app. -
callbackUrl
(type:String.t
, default:nil
) - Callback URL used by OAuth 2.0 authorization servers to communicate authorization codes back to developer apps. -
createdAt
(type:String.t
, default:nil
) - Output only. Time the developer app was created in milliseconds since epoch. -
credentials
(type:list(GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1Credential.t)
, default:nil
) - Output only. Set of credentials for the developer app consisting of the consumer key/secret pairs associated with the API products. -
developerId
(type:String.t
, default:nil
) - ID of the developer. -
keyExpiresIn
(type:String.t
, default:nil
) - Expiration time, in milliseconds, for the consumer key that is generated for the developer app. If not set or left to the default value of-1
, the API key never expires. The expiration time can't be updated after it is set. -
lastModifiedAt
(type:String.t
, default:nil
) - Output only. Time the developer app was modified in milliseconds since epoch. -
name
(type:String.t
, default:nil
) - Name of the developer app. -
scopes
(type:list(String.t)
, default:nil
) - Scopes to apply to the developer app. The specified scopes must already exist for the API product that you associate with the developer app. -
status
(type:String.t
, default:nil
) - Status of the credential. Valid values includeapproved
orrevoked
.
Attributes
-
apiProducts
(type:list(any())
, default:nil
) - List of API products for which the credential can be used. Note: Do not specify the list of API products when creating a consumer key and secret for a developer app. Instead, use the UpdateDeveloperAppKey API to make the association after the consumer key and secret are created. -
attributes
(type:list(GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1Attribute.t)
, default:nil
) - List of attributes associated with the credential. -
consumerKey
(type:String.t
, default:nil
) - Consumer key. -
consumerSecret
(type:String.t
, default:nil
) - Secret key. -
expiresAt
(type:String.t
, default:nil
) - Time the developer app expires in milliseconds since epoch. -
issuedAt
(type:String.t
, default:nil
) - Time the developer app was created in milliseconds since epoch. -
scopes
(type:list(String.t)
, default:nil
) - Scopes to apply to the app. The specified scope names must already be defined for the API product that you associate with the app. -
status
(type:String.t
, default:nil
) - Status of the credential. Valid values includeapproved
orrevoked
.
This message type encapsulates a metric grouped by dimension.
Metadata common to many entities in this API.
Attributes
-
createdAt
(type:String.t
, default:nil
) - Output only. Creation time of this environment as milliseconds since epoch. -
description
(type:String.t
, default:nil
) - Optional. Description of the environment. -
displayName
(type:String.t
, default:nil
) - Optional. Display name for this environment. -
lastModifiedAt
(type:String.t
, default:nil
) - Output only. Last modification time of this environment as milliseconds since epoch. -
name
(type:String.t
, default:nil
) - Required. Name of the environment. Values must match the regular expression^[.\\p{Alnum}-_]{1,255}$
-
properties
(type:GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1Properties.t
, default:nil
) - Optional. Key-value pairs that may be used for customizing the environment.
Attributes
-
createTime
(type:DateTime.t
, default:nil
) - Time that the environment configuration was created. -
dataCollectors
(type:list(GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1DataCollectorConfig.t)
, default:nil
) - List of data collectors used by the deployments in the environment. -
debugMask
(type:GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1DebugMask.t
, default:nil
) - Debug mask that applies to all deployments in the environment. -
deployments
(type:list(GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1DeploymentConfig.t)
, default:nil
) - List of deployments in the environment. -
featureFlags
(type:map()
, default:nil
) - Feature flags inherited from the organization and environment. -
flowhooks
(type:list(GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1FlowHookConfig.t)
, default:nil
) - List of flow hooks in the environment. -
keystores
(type:list(GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1KeystoreConfig.t)
, default:nil
) - List of keystores in the environment. -
name
(type:String.t
, default:nil
) - Name of the environment configuration in the following format:organizations/{org}/environments/{env}/configs/{config}
-
provider
(type:String.t
, default:nil
) - Used by the Control plane to add context information to help detect the source of the document during diagnostics and debugging. -
pubsubTopic
(type:String.t
, default:nil
) - Name of the PubSub topic for the environment. -
resourceReferences
(type:list(GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1ReferenceConfig.t)
, default:nil
) - List of resource references in the environment. -
resources
(type:list(GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1ResourceConfig.t)
, default:nil
) - List of resource versions in the environment. -
revisionId
(type:String.t
, default:nil
) - Revision ID of the environment configuration. The higher the value, the more recently the configuration was deployed. -
sequenceNumber
(type:String.t
, default:nil
) - DEPRECATED: Use revision_id. -
targets
(type:list(GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1TargetServerConfig.t)
, default:nil
) - List of target servers in the environment. Disabled target servers are not displayed. -
traceConfig
(type:GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1RuntimeTraceConfig.t
, default:nil
) - Trace configurations. Contains config for the environment and config overrides for specific API proxies. -
uid
(type:String.t
, default:nil
) - Unique ID for the environment configuration. The ID will only change if the environment is deleted and recreated.
EnvironmentGroup configuration. An environment group is used to group one or more Apigee environments under a single host name.
EnvironmentGroupAttachment is a resource which defines an attachment of an environment to an environment group.
EnvironmentGroupConfig is a revisioned snapshot of an EnvironmentGroup and its associated routing rules.
Details of an export job.
Request body for [CreateExportRequest]
Attributes
-
continueOnError
(type:boolean()
, default:nil
) - Optional. Flag that specifies whether execution should continue if the flow hook throws an exception. Set totrue
to continue execution. Set tofalse
to stop execution if the flow hook throws an exception.Defaults totrue
. -
description
(type:String.t
, default:nil
) - Description of the flow hook. -
flowHookPoint
(type:String.t
, default:nil
) - Output only. Where in the API call flow the flow hook is invoked. Must be one ofPreProxyFlowHook
,PostProxyFlowHook
,PreTargetFlowHook
, orPostTargetFlowHook
. -
sharedFlow
(type:String.t
, default:nil
) - Shared flow attached to this flow hook, or empty if there is none attached.
Attributes
-
continueOnError
(type:boolean()
, default:nil
) - Flag that specifies whether the flow should abort after an error in the flow hook. Defaults totrue
(continue on error). -
name
(type:String.t
, default:nil
) - Name of the flow hook in the following format:organizations/{org}/environments/{env}/flowhooks/{point}
. Validpoint
values include:PreProxyFlowHook
,PostProxyFlowHook
,PreTargetFlowHook
, andPostTargetFlowHook
-
sharedFlowName
(type:String.t
, default:nil
) - Name of the shared flow to invoke in the following format:organizations/{org}/sharedflows/{sharedflow}
Request for GetSyncAuthorization.
Attributes
-
environmentGroups
(type:list(GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1EnvironmentGroupConfig.t)
, default:nil
) - List of environment groups in the organization. -
name
(type:String.t
, default:nil
) - Name of the resource in the following format:organizations/{org}/deployedIngressConfig
. -
revisionCreateTime
(type:DateTime.t
, default:nil
) - Time at which the IngressConfig revision was created. -
revisionId
(type:String.t
, default:nil
) - Revision id that defines the ordering on IngressConfig resources. The higher the revision, the more recently the configuration was deployed. -
uid
(type:String.t
, default:nil
) - A unique id for the ingress config that will only change if the organization is deleted and recreated.
Apigee runtime instance.
InstanceAttachment represents the installation of an environment onto an instance.
The status of a deployment as reported by a single instance.
Revisions deployed in the MPs.
A route deployed in the ingress routing table.
A collection of key, value string pairs
A datastore for Certificates and Aliases
the response for ListApiCategoriesRequest.
The response for ListAsyncQueries.
This message encapsulates a list of custom report definitions
The response for ListDatastores
Attributes
-
nextPageToken
(type:String.t
, default:nil
) - Page token that you can include in a ListDebugSessionsRequest to retrieve the next page. If omitted, no subsequent pages exist. -
sessions
(type:list(GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1Session.t)
, default:nil
) - Session info that includes debug session ID and the first transaction creation timestamp.
Response for ListEnvironmentGroupAttachments.
Response for ListEnvironmentGroups.
Response for ListEnvironmentResources
The response for ListExports
Response for ListInstanceAttachments.
Response for ListInstances.
This message type encapsulates additional information about query execution.
This message type encapsulates the metric data point. Example: { "name": "sum(message_count)", "values" : [ { "timestamp": 1549004400000, "value": "39.0" }, { "timestamp" : 1548997200000, "value" : "0.0" } ] } or { "name": "sum(message_count)", "values" : ["39.0"] }
Operation represents the pairing of REST resource path and the actions (verbs) allowed on the resource path.
OperationConfig binds the resources in a proxy or remote service with the allowed REST methods and its associated quota enforcement.
The OperationGroup contains a list of configuration details associated with Apigee proxies or Remote services. Remote services are non-Apigee Edge proxies. eg, Istio-Envoy.
Metadata describing an Operation.
Attributes
-
Response
(type:GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1OptimizedStatsResponse.t
, default:nil
) - This field wraps the stats response for Js Optimized Scenario with a Response key. E.g. { "Response": { "TimeUnit": [], "metaData": { "errors": [], "notices": [ "Source:Postgres", "Table used: edge.api.aaxgroup001.agg_api", "PG Host:ruappg08-ro.production.apigeeks.net", "query served by:80c4ebca-6a10-4a2e-8faf-c60c1ee306ca" ] }, "resultTruncated": false, "stats": { "data": [ { "identifier": { "names": [ "apiproxy" ], "values": [ "sirjee" ] }, "metric": [ { "env": "prod", "name": "sum(message_count)", "values": [ 36.0 ] }, { "env": "prod", "name": "sum(is_error)", "values": [ 36.0 ] } ] } ] } } }
This message type encapsulates a data node as represented below: { "identifier": { "names": [ "apiproxy" ], "values": [ "sirjee" ] }, "metric": [ { "env": "prod", "name": "sum(message_count)", "values": [ 36.0 ] } ] } OR { "env": "prod", "name": "sum(message_count)", "values": [ 36.0 ] } Depending on whether a dimension is present in the query or not the data node type can be a simple metric value or dimension identifier with list of metrics.
This message type encapsulates a response format for Js Optimized Scenario.
Attributes
-
analyticsRegion
(type:String.t
, default:nil
) - Required. Primary GCP region for analytics data storage. For valid values, see Create an Apigee organization. -
attributes
(type:list(String.t)
, default:nil
) - Not used by Apigee. -
authorizedNetwork
(type:String.t
, default:nil
) - 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 can be updated only when there are no runtime instances. For example: "default". Note: Not supported for Apigee hybrid. -
caCertificate
(type:String.t
, default:nil
) - Output only. Base64-encoded public certificate for the root CA of the Apigee organization. Valid only when [RuntimeType] is CLOUD. -
createdAt
(type:String.t
, default:nil
) - Output only. Time that the Apigee organization was created in milliseconds since epoch. -
customerName
(type:String.t
, default:nil
) - Not used by Apigee. -
description
(type:String.t
, default:nil
) - Description of the Apigee organization. -
displayName
(type:String.t
, default:nil
) - -
environments
(type:list(String.t)
, default:nil
) - Output only. List of environments in the Apigee organization. -
lastModifiedAt
(type:String.t
, default:nil
) - Output only. Time that the Apigee organization was last modified in milliseconds since epoch. -
name
(type:String.t
, default:nil
) - Output only. Name of the Apigee organization. -
projectId
(type:String.t
, default:nil
) - The project ID associated with the Apigee organization. -
properties
(type:GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1Properties.t
, default:nil
) - Properties defined in the Apigee organization profile. -
runtimeType
(type:String.t
, default:nil
) - Required. Runtime type of the Apigee organization based on the Apigee subscription purchased. -
subscriptionType
(type:String.t
, default:nil
) - Output only. 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. -
type
(type:String.t
, default:nil
) - Not used by Apigee.
Attributes
-
appVersion
(type:String.t
, default:nil
) - Version of the application running in the pod. -
deploymentStatus
(type:String.t
, default:nil
) - Status of the deployment. Valid values include: -deployed
: Successful. -error
: Failed. -pending
: Pod has not yet reported on the deployment. -
deploymentStatusTime
(type:String.t
, default:nil
) - Time the deployment status was reported in milliseconds since epoch. -
deploymentTime
(type:String.t
, default:nil
) - Time the proxy was deployed in milliseconds since epoch. -
podName
(type:String.t
, default:nil
) - Name of the pod which is reporting the status. -
podStatus
(type:String.t
, default:nil
) - Overall status of the pod (not this specific deployment). Valid values include: -active
: Up to date. -stale
: Recently out of date. Pods that have not reported status in a long time are excluded from the output. -
podStatusTime
(type:String.t
, default:nil
) - Time the pod status was reported in milliseconds since epoch. -
statusCode
(type:String.t
, default:nil
) - Code associated with the deployment status. -
statusCodeDetails
(type:String.t
, default:nil
) - Human-readable message associated with the status code.
Point is a group of information collected by runtime plane at critical points of the message flow of the processed API request. This is a list of supported point IDs, categorized to three major buckets. For each category, debug points that we are currently supporting are listed below: - Flow status debug points: StateChange FlowInfo Condition Execution DebugMask Error - Flow control debug points: FlowCallout Paused Resumed FlowReturn BreakFlow Error - Runtime debug points: ScriptExecutor FlowCalloutStepDefinition CustomTarget StepDefinition Oauth2ServicePoint RaiseFault NodeJS The detail information of the given debug point is stored in a list of results.
Message for compatibility with legacy Edge specification for Java Properties object in JSON.
A single property entry in the Properties message.
Request for ProvisionOrganization.
Attributes
-
csvDelimiter
(type:String.t
, default:nil
) - Delimiter used in the CSV file, ifoutputFormat
is set tocsv
. Defaults to the,
(comma) character. Supported delimiter characters include comma (,
), pipe (|
), and tab (\t
). -
dimensions
(type:list(String.t)
, default:nil
) - A list of dimensions. https://docs.apigee.com/api-platform/analytics/analytics-reference#dimensions -
filter
(type:String.t
, default:nil
) - Boolean expression that can be used to filter data. Filter expressions can be combined using AND/OR terms and should be fully parenthesized to avoid ambiguity. See Analytics metrics, dimensions, and filters reference https://docs.apigee.com/api-platform/analytics/analytics-reference for more information on the fields available to filter on. For more information on the tokens that you use to build filter expressions, see Filter expression syntax. https://docs.apigee.com/api-platform/analytics/asynch-reports-api#filter-expression-syntax -
groupByTimeUnit
(type:String.t
, default:nil
) - Time unit used to group the result set. Valid values include: second, minute, hour, day, week, or month. If a query includes groupByTimeUnit, then the result is an aggregation based on the specified time unit and the resultant timestamp does not include milliseconds precision. If a query omits groupByTimeUnit, then the resultant timestamp includes milliseconds precision. -
limit
(type:integer()
, default:nil
) - Maximum number of rows that can be returned in the result. -
metrics
(type:list(GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1QueryMetric.t)
, default:nil
) - A list of Metrics. -
name
(type:String.t
, default:nil
) - Asynchronous Query Name. -
outputFormat
(type:String.t
, default:nil
) - Valid values include:csv
orjson
. Defaults tojson
. Note: Configure the delimiter for CSV output using the csvDelimiter property. -
reportDefinitionId
(type:String.t
, default:nil
) - Asynchronous Report ID. -
timeRange
(type:any()
, default:nil
) - Required. Time range for the query. Can use the following predefined strings to specify the time range:last60minutes
last24hours
last7days
Or, specify the timeRange as a structure describing start and end timestamps in the ISO format: yyyy-mm-ddThh:mm:ssZ. Example: "timeRange": { "start": "2018-07-29T00:13:00Z", "end": "2018-08-01T00:18:00Z" }
Attributes
-
dimensions
(type:list(String.t)
, default:nil
) - Dimensions of the AsyncQuery. -
endTimestamp
(type:String.t
, default:nil
) - End timestamp of the query range. -
metrics
(type:list(String.t)
, default:nil
) - Metrics of the AsyncQuery. Example: ["name:message_count,func:sum,alias:sum_message_count"] -
outputFormat
(type:String.t
, default:nil
) - Output format. -
startTimestamp
(type:String.t
, default:nil
) - Start timestamp of the query range. -
timeUnit
(type:String.t
, default:nil
) - Query GroupBy time unit.
More info about Metric: https://docs.apigee.com/api-platform/analytics/analytics-reference#metrics
Quota contains the essential parameters needed that can be applied on a proxy/remote service, resources and methods combination associated with this API product. While setting of Quota is optional, setting it prevents requests from exceeding the provisioned parameters.
A Reference configuration. References must refer to a keystore that also exists in the parent environment.
Attributes
-
name
(type:String.t
, default:nil
) - Name of the reference in the following format:organizations/{org}/environments/{env}/references/{reference}
-
resourceName
(type:String.t
, default:nil
) - Name of the referenced resource in the following format:organizations/{org}/environments/{env}/keystores/{keystore}
Only references to keystore resources are supported.
Request for ReportInstanceStatus.
Placeholder for future enhancements to status reporting protocol
Attributes
-
location
(type:String.t
, default:nil
) - Location of the resource as a URI. -
name
(type:String.t
, default:nil
) - Resource name in the following format:organizations/{org}/environments/{env}/resourcefiles/{type}/{file}/revisions/{rev}
Only environment-scoped resource files are supported.
Metadata about a resource file.
List of resource files.
The status of a resource loaded in the runtime.
Result is short for "action result", could be different types identified by "action_result" field. Supported types: 1. DebugInfo : generic debug info collected by runtime recorded as a list of properties. For example, the contents could be virtual host info, state change result, or execution metadata. Required fields : properties, timestamp 2. RequestMessage: information of a http request. Contains headers, request URI and http methods type.Required fields : headers, uri, verb 3. ResponseMessage: information of a http response. Contains headers, reason phrase and http status code. Required fields : headers, reasonPhrase, statusCode 4. ErrorMessage: information of a http error message. Contains detail error message, reason phrase and status code. Required fields : content, headers, reasonPhrase, statusCode 5. VariableAccess: a list of variable access actions, can be Get, Set and Remove. Required fields : accessList
The status of a specific resource revision.
Attributes
-
basepath
(type:String.t
, default:nil
) - 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. -
envGroupRevision
(type:String.t
, default:nil
) - 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 debug=true. -
environment
(type:String.t
, default:nil
) - Name of an environment bound to the environment group in the following format:organizations/{org}/environments/{env}
. -
receiver
(type:String.t
, default:nil
) - 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 debug=true. -
updateTime
(type:DateTime.t
, default:nil
) - 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 debug=true.
NEXT ID: 8 RuntimeTraceConfig defines the configurations for distributed trace in an environment.
NEXT ID: 7 Trace configuration override for a specific API proxy in an environment.
NEXT ID: 6 RuntimeTraceSamplingConfig represents the detail settings of distributed tracing. Only the fields that are defined in the distributed trace configuration can be overridden using the distribute trace configuration override APIs.
ResponseCodeRange represents a group of response codes to capture, from the first response code to the last response code. Each range is a close interval. For example, if an interval is [400, 403], then that means 400, 401, 402, 403 will be all captured.
Response for Schema call
Message type for the schema element
Message type for schema property
Session carries the debug session id and its creation time.
The metadata describing a shared flow
The metadata describing a shared flow revision.
This message type encapsulates a stats response.
This message type encapsulates the environment wrapper: "environments": [ { "metrics": [ { "name": "sum(message_count)", "values": [ "2.52056245E8" ] } ], "name": "prod" } ]
Pub/Sub subscription of an environment.
Attributes
-
etag
(type:String.t
, default:nil
) - 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 an ETag is returned in the response. Pass that ETag when calling the setSyncAuthorization to ensure that you are updating the correct version. If you don't pass the ETag in the call tosetSyncAuthorization
, 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. -
identities
(type:list(String.t)
, default:nil
) - 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.
TargetServer configuration. TargetServers are used to decouple a proxy's TargetEndpoint HTTPTargetConnections from concrete URLs for backend services.
Attributes
-
host
(type:String.t
, default:nil
) - Host name of the target server. -
name
(type:String.t
, default:nil
) - Target server revision name in the following format:organizations/{org}/environments/{env}/targetservers/{targetserver}/revisions/{rev}
-
port
(type:integer()
, default:nil
) - Port number for the target server. -
tlsInfo
(type:GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1TlsInfoConfig.t
, default:nil
) - TLS settings for the target server.
The response for TestDatastore
TLS configuration information for VirtualHosts and TargetServers.
Attributes
-
ciphers
(type:list(String.t)
, default:nil
) - List of ciphers that are granted access. -
clientAuthEnabled
(type:boolean()
, default:nil
) - Flag that specifies whether client-side authentication is enabled for the target server. Enables two-way TLS. -
commonName
(type:GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1CommonNameConfig.t
, default:nil
) - Common name to validate the target server against. -
enabled
(type:boolean()
, default:nil
) - Flag that specifies whether one-way TLS is enabled. Set totrue
to enable one-way TLS. -
ignoreValidationErrors
(type:boolean()
, default:nil
) - Flag that specifies whether to ignore TLS certificate validation errors. Set totrue
to ignore errors. -
keyAlias
(type:String.t
, default:nil
) - Name of the alias used for client-side authentication in the following format:organizations/{org}/environments/{env}/keystores/{keystore}/aliases/{alias}
-
keyAliasReference
(type:GoogleApi.Apigee.V1.Model.GoogleCloudApigeeV1KeyAliasReference.t
, default:nil
) - Reference name and alias pair to use for client-side authentication. -
protocols
(type:list(String.t)
, default:nil
) - List of TLS protocols that are granted access. -
trustStore
(type:String.t
, default:nil
) - Name of the keystore or keystore reference containing trusted certificates for the server in the following format:organizations/{org}/environments/{env}/keystores/{keystore}
ororganizations/{org}/environments/{env}/references/{reference}
Details on why a resource update failed in the runtime.
Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both allServices
and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { "audit_configs": [ { "service": "allServices", "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" }, { "log_type": "ADMIN_READ" } ] }, { "service": "sampleservice.googleapis.com", "audit_log_configs": [ { "log_type": "DATA_READ" }, { "log_type": "DATA_WRITE", "exempted_members": [ "user:aliya@example.com" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts jose@example.com from DATA_READ logging, and aliya@example.com from DATA_WRITE logging.
Provides the configuration for logging a type of permissions. Example: { "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" } ] } This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from DATA_READ logging.
Associates members
with a role
.
An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A Policy
is a collection of bindings
. A binding
binds one or more members
to a single role
. Members can be user accounts, service accounts, Google groups, and domains (such as G Suite). A role
is a named list of permissions; each role
can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a binding
can also specify a condition
, which is a logical expression that allows access to a resource only if the expression evaluates to true
. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the IAM documentation. JSON example: { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { "role": "roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com" ], "condition": { "title": "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": "BwWWja0YfJA=", "version": 3 } YAML example: bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: 3 For a description of IAM and its features, see the IAM documentation.
Request message for SetIamPolicy
method.
Request message for TestIamPermissions
method.
Response message for TestIamPermissions
method.
The response message for Operations.ListOperations.
This resource represents a long-running operation that is the result of a network API call.
A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for Empty
is empty JSON object {}
.
Describes what preconditions have failed. For example, if an RPC failed because it required the Terms of Service to be acknowledged, it could list the terms of service violation in the PreconditionFailure message.
A message type used to describe a single precondition failure.
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. 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.
Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: "Summary size limit" description: "Determines if a summary is less than 100 chars" expression: "document.summary.size() < 100" Example (Equality): title: "Requestor is owner" description: "Determines if requestor is the document owner" expression: "document.owner == request.auth.claims.email" Example (Logic): title: "Public documents" description: "Determine whether the document should be publicly visible" expression: "document.type != 'private' && document.type != 'internal'" Example (Data Manipulation): title: "Notification string" description: "Create a notification string with a timestamp." expression: "'New message received at ' + string(document.create_time)" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information.