{ "documentationLink": "https://cloud.google.com/apigee-api-management/", "batchPath": "batch", "protocol": "rest", "version_module": true, "baseUrl": "https://apigee.googleapis.com/", "name": "apigee", "ownerDomain": "google.com", "title": "Apigee API", "kind": "discovery#restDescription", "basePath": "", "discoveryVersion": "v1", "ownerName": "Google", "parameters": { "callback": { "type": "string", "location": "query", "description": "JSONP" }, "upload_protocol": { "location": "query", "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", "type": "string" }, "access_token": { "type": "string", "location": "query", "description": "OAuth access token." }, "fields": { "description": "Selector specifying which fields to include in a partial response.", "type": "string", "location": "query" }, "quotaUser": { "location": "query", "type": "string", "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters." }, "uploadType": { "type": "string", "location": "query", "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\")." }, "alt": { "enum": [ "json", "media", "proto" ], "default": "json", "description": "Data format for response.", "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ], "type": "string", "location": "query" }, "key": { "location": "query", "type": "string", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." }, "$.xgafv": { "enumDescriptions": [ "v1 error format", "v2 error format" ], "enum": [ "1", "2" ], "description": "V1 error format.", "location": "query", "type": "string" }, "prettyPrint": { "type": "boolean", "description": "Returns response with indentations and line breaks.", "location": "query", "default": "true" }, "oauth_token": { "location": "query", "type": "string", "description": "OAuth 2.0 token for the current user." } }, "version": "v1", "id": "apigee:v1", "description": "Use the Apigee API to programmatically develop and manage APIs with a set of RESTful operations. Develop and secure API proxies, deploy and undeploy API proxy revisions, monitor APIs, configure environments, manage users, and more. Note: This product is available as a free trial for a time period of 60 days.", "mtlsRootUrl": "https://apigee.mtls.googleapis.com/", "resources": { "hybrid": { "resources": { "issuers": { "methods": { "list": { "path": "v1/{+name}", "response": { "$ref": "GoogleCloudApigeeV1ListHybridIssuersResponse" }, "parameters": { "name": { "type": "string", "location": "path", "description": "Required. Must be of the form `hybrid/issuers`.", "required": true, "pattern": "^hybrid/issuers$" } }, "description": "Lists hybrid services and its trusted issuers service account ids. This api is authenticated and unauthorized(allow all the users) and used by runtime authn-authz service to query control plane's issuer service account ids.", "flatPath": "v1/hybrid/issuers", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.hybrid.issuers.list", "httpMethod": "GET" } } } } }, "organizations": { "resources": { "securityProfiles": { "resources": { "environments": { "methods": { "delete": { "parameterOrder": [ "name" ], "parameters": { "name": { "location": "path", "description": "Required. The name of the environment attachment to delete. Format: organizations/{org}/securityProfiles/{profile}/environments/{env}", "required": true, "pattern": "^organizations/[^/]+/securityProfiles/[^/]+/environments/[^/]+$", "type": "string" } }, "path": "v1/{+name}", "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.securityProfiles.environments.delete", "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1/organizations/{organizationsId}/securityProfiles/{securityProfilesId}/environments/{environmentsId}", "description": "DeleteSecurityProfileEnvironmentAssociation removes profile environment association i.e. detaches environment from security profile." }, "computeEnvironmentScores": { "parameters": { "profileEnvironment": { "location": "path", "type": "string", "pattern": "^organizations/[^/]+/securityProfiles/[^/]+/environments/[^/]+$", "description": "Required. Name of organization and environment and profile id for which score needs to be computed. Format: organizations/{org}/securityProfiles/{profile}/environments/{env}", "required": true } }, "id": "apigee.organizations.securityProfiles.environments.computeEnvironmentScores", "flatPath": "v1/organizations/{organizationsId}/securityProfiles/{securityProfilesId}/environments/{environmentsId}:computeEnvironmentScores", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1ComputeEnvironmentScoresResponse" }, "description": "ComputeEnvironmentScores calculates scores for requested time range for the specified security profile and environment.", "path": "v1/{+profileEnvironment}:computeEnvironmentScores", "request": { "$ref": "GoogleCloudApigeeV1ComputeEnvironmentScoresRequest" }, "httpMethod": "POST", "parameterOrder": [ "profileEnvironment" ] }, "create": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/securityProfiles/{securityProfilesId}/environments", "description": "CreateSecurityProfileEnvironmentAssociation creates profile environment association i.e. attaches environment to security profile.", "parameterOrder": [ "parent" ], "parameters": { "parent": { "required": true, "location": "path", "pattern": "^organizations/[^/]+/securityProfiles/[^/]+$", "type": "string", "description": "Required. Name of organization and security profile ID. Format: organizations/{org}/securityProfiles/{profile}" } }, "path": "v1/{+parent}/environments", "id": "apigee.organizations.securityProfiles.environments.create", "httpMethod": "POST", "request": { "$ref": "GoogleCloudApigeeV1SecurityProfileEnvironmentAssociation" }, "response": { "$ref": "GoogleCloudApigeeV1SecurityProfileEnvironmentAssociation" } } } } }, "methods": { "listRevisions": { "response": { "$ref": "GoogleCloudApigeeV1ListSecurityProfileRevisionsResponse" }, "httpMethod": "GET", "parameters": { "pageToken": { "description": "A page token, received from a previous `ListSecurityProfileRevisions` call. Provide this to retrieve the subsequent page.", "type": "string", "location": "query" }, "pageSize": { "description": "The maximum number of profile revisions to return. The service may return fewer than this value. If unspecified, at most 50 revisions will be returned.", "format": "int32", "type": "integer", "location": "query" }, "name": { "location": "path", "required": true, "pattern": "^organizations/[^/]+/securityProfiles/[^/]+$", "type": "string", "description": "Required. For a specific profile, list all the revisions. Format: `organizations/{org}/securityProfiles/{profile}`" } }, "path": "v1/{+name}:listRevisions", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "ListSecurityProfileRevisions lists all the revisions of the security profile.", "id": "apigee.organizations.securityProfiles.listRevisions", "flatPath": "v1/organizations/{organizationsId}/securityProfiles/{securityProfilesId}:listRevisions", "parameterOrder": [ "name" ] }, "patch": { "parameterOrder": [ "name" ], "httpMethod": "PATCH", "id": "apigee.organizations.securityProfiles.patch", "response": { "$ref": "GoogleCloudApigeeV1SecurityProfile" }, "request": { "$ref": "GoogleCloudApigeeV1SecurityProfile" }, "flatPath": "v1/organizations/{organizationsId}/securityProfiles/{securityProfilesId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "UpdateSecurityProfile update the metadata of security profile.", "parameters": { "updateMask": { "location": "query", "description": "Required. The list of fields to update.", "type": "string", "format": "google-fieldmask" }, "name": { "location": "path", "type": "string", "pattern": "^organizations/[^/]+/securityProfiles/[^/]+$", "required": true, "description": "Immutable. Name of the security profile resource. Format: organizations/{org}/securityProfiles/{profile}" } }, "path": "v1/{+name}" }, "list": { "response": { "$ref": "GoogleCloudApigeeV1ListSecurityProfilesResponse" }, "flatPath": "v1/organizations/{organizationsId}/securityProfiles", "parameterOrder": [ "parent" ], "description": "ListSecurityProfiles lists all the security profiles associated with the org including attached and unattached profiles.", "id": "apigee.organizations.securityProfiles.list", "path": "v1/{+parent}/securityProfiles", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "pageSize": { "description": "The maximum number of profiles to return. The service may return fewer than this value. If unspecified, at most 50 profiles will be returned.", "format": "int32", "type": "integer", "location": "query" }, "parent": { "description": "Required. For a specific organization, list of all the security profiles. Format: `organizations/{org}`", "pattern": "^organizations/[^/]+$", "required": true, "location": "path", "type": "string" }, "pageToken": { "description": "A page token, received from a previous `ListSecurityProfiles` call. Provide this to retrieve the subsequent page.", "location": "query", "type": "string" } } }, "get": { "flatPath": "v1/organizations/{organizationsId}/securityProfiles/{securityProfilesId}", "id": "apigee.organizations.securityProfiles.get", "response": { "$ref": "GoogleCloudApigeeV1SecurityProfile" }, "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "Required. Security profile in the following format: `organizations/{org}/securityProfiles/{profile}'. Profile may optionally contain revision ID. If revision ID is not provided, the response will contain latest revision by default. Example: organizations/testOrg/securityProfiles/testProfile@5", "location": "path", "pattern": "^organizations/[^/]+/securityProfiles/[^/]+$", "type": "string", "required": true } }, "description": "GetSecurityProfile gets the specified security profile. Returns NOT_FOUND if security profile is not present for the specified organization.", "httpMethod": "GET", "parameterOrder": [ "name" ] }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "description": "Required. Name of profile. Format: organizations/{org}/securityProfiles/{profile}", "required": true, "location": "path", "pattern": "^organizations/[^/]+/securityProfiles/[^/]+$" } }, "id": "apigee.organizations.securityProfiles.delete", "response": { "$ref": "GoogleProtobufEmpty" }, "description": "DeleteSecurityProfile delete a profile with all its revisions.", "httpMethod": "DELETE", "flatPath": "v1/organizations/{organizationsId}/securityProfiles/{securityProfilesId}" }, "create": { "description": "CreateSecurityProfile create a new custom security profile.", "response": { "$ref": "GoogleCloudApigeeV1SecurityProfile" }, "id": "apigee.organizations.securityProfiles.create", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudApigeeV1SecurityProfile" }, "httpMethod": "POST", "parameters": { "securityProfileId": { "location": "query", "type": "string", "description": "Required. The ID to use for the SecurityProfile, which will become the final component of the action's resource name. This value should be 1-63 characters and validated by \"(^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$)\"." }, "parent": { "description": "Required. Name of organization. Format: organizations/{org}", "required": true, "location": "path", "type": "string", "pattern": "^organizations/[^/]+$" } }, "path": "v1/{+parent}/securityProfiles", "flatPath": "v1/organizations/{organizationsId}/securityProfiles", "parameterOrder": [ "parent" ] } } }, "operations": { "methods": { "list": { "parameters": { "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "filter": { "location": "query", "type": "string", "description": "The standard list filter." }, "pageSize": { "location": "query", "format": "int32", "description": "The standard list page size.", "type": "integer" }, "name": { "required": true, "type": "string", "pattern": "^organizations/[^/]+$", "description": "The name of the operation's parent resource.", "location": "path" } }, "flatPath": "v1/organizations/{organizationsId}/operations", "parameterOrder": [ "name" ], "path": "v1/{+name}/operations", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "httpMethod": "GET", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "id": "apigee.organizations.operations.list" }, "get": { "id": "apigee.organizations.operations.get", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "flatPath": "v1/organizations/{organizationsId}/operations/{operationsId}", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "parameters": { "name": { "pattern": "^organizations/[^/]+/operations/[^/]+$", "description": "The name of the operation resource.", "required": true, "type": "string", "location": "path" } }, "path": "v1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" } } } }, "appgroups": { "resources": { "apps": { "methods": { "create": { "parameters": { "parent": { "required": true, "location": "path", "pattern": "^organizations/[^/]+/appgroups/[^/]+$", "description": "Required. Name of the AppGroup. Use the following structure in your request: `organizations/{org}/appgroups/{app_group_name}`", "type": "string" } }, "path": "v1/{+parent}/apps", "httpMethod": "POST", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1AppGroupApp" }, "description": "Creates an app and associates it with an AppGroup. This API associates the AppGroup app with the specified API product and auto-generates an API key for the app to use in calls to API proxies inside that API product. The `name` is the unique ID of the app that you can use in API calls.", "id": "apigee.organizations.appgroups.apps.create", "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/apps", "request": { "$ref": "GoogleCloudApigeeV1AppGroupApp" } }, "get": { "path": "v1/{+name}", "parameterOrder": [ "name" ], "id": "apigee.organizations.appgroups.apps.get", "description": "Returns the details for an AppGroup app.", "httpMethod": "GET", "response": { "$ref": "GoogleCloudApigeeV1AppGroupApp" }, "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/apps/{appsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "Required. Name of the AppGroup app. Use the following structure in your request: `organizations/{org}/appgroups/{app_group_name}/apps/{app}`", "pattern": "^organizations/[^/]+/appgroups/[^/]+/apps/[^/]+$", "location": "path", "required": true, "type": "string" } } }, "list": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "pageToken": { "description": "Optional. Page token. If provides, must be a valid AppGroup app returned from a previous call that can be used to retrieve the next page.", "type": "string", "location": "query" }, "pageSize": { "format": "int32", "location": "query", "type": "integer", "description": "Optional. Maximum number entries to return. If unspecified, at most 1000 entries will be returned." }, "parent": { "description": "Required. Name of the AppGroup. Use the following structure in your request: `organizations/{org}/appgroups/{app_group_name}`", "pattern": "^organizations/[^/]+/appgroups/[^/]+$", "type": "string", "location": "path", "required": true } }, "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/apps", "parameterOrder": [ "parent" ], "id": "apigee.organizations.appgroups.apps.list", "description": "Lists all apps created by an AppGroup in an Apigee organization. Optionally, you can request an expanded view of the AppGroup apps. Lists all AppGroupApps in an AppGroup. A maximum of 1000 AppGroup apps are returned in the response if PageSize is not specified, or if the PageSize is greater than 1000.", "path": "v1/{+parent}/apps", "response": { "$ref": "GoogleCloudApigeeV1ListAppGroupAppsResponse" } }, "update": { "parameters": { "name": { "pattern": "^organizations/[^/]+/appgroups/[^/]+/apps/[^/]+$", "type": "string", "location": "path", "description": "Required. Name of the AppGroup app. Use the following structure in your request: `organizations/{org}/appgroups/{app_group_name}/apps/{app}`", "required": true }, "action": { "location": "query", "description": "Approve or revoke the consumer key by setting this value to `approve` or `revoke`. The `Content-Type` header must be set to `application/octet-stream`, with empty body.", "type": "string" } }, "id": "apigee.organizations.appgroups.apps.update", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "PUT", "description": "Updates the details for an AppGroup app. In addition, you can add an API product to an AppGroup app and automatically generate an API key for the app to use when calling APIs in the API product. If you want to use an existing API key for the API product, add the API product to the API key using the UpdateAppGroupAppKey API. Using this API, you cannot update the app name, as it is the primary key used to identify the app and cannot be changed. This API replaces the existing attributes with those specified in the request. Include or exclude any existing attributes that you want to retain or delete, respectively.", "response": { "$ref": "GoogleCloudApigeeV1AppGroupApp" }, "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/apps/{appsId}", "request": { "$ref": "GoogleCloudApigeeV1AppGroupApp" }, "parameterOrder": [ "name" ], "path": "v1/{+name}" }, "delete": { "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/apps/{appsId}", "parameters": { "name": { "required": true, "type": "string", "pattern": "^organizations/[^/]+/appgroups/[^/]+/apps/[^/]+$", "description": "Required. Name of the AppGroup app. Use the following structure in your request: `organizations/{org}/appgroups/{app_group_name}/apps/{app}`", "location": "path" } }, "id": "apigee.organizations.appgroups.apps.delete", "httpMethod": "DELETE", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "response": { "$ref": "GoogleCloudApigeeV1AppGroupApp" }, "description": "Deletes an AppGroup app. **Note**: The delete operation is asynchronous. The AppGroup app is deleted immediately, but its associated resources, such as app keys or access tokens, may take anywhere from a few seconds to a few minutes to be deleted." } }, "resources": { "keys": { "resources": { "apiproducts": { "methods": { "delete": { "httpMethod": "DELETE", "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/apps/{appsId}/keys/{keysId}/apiproducts/{apiproductsId}", "parameters": { "name": { "location": "path", "type": "string", "pattern": "^organizations/[^/]+/appgroups/[^/]+/apps/[^/]+/keys/[^/]+/apiproducts/[^/]+$", "description": "Required. Parent of the AppGroup app key. Use the following structure in your request: `organizations/{org}/appgroups/{app_group_name}/apps/{app}/keys/{key}/apiproducts/{apiproduct}`", "required": true } }, "parameterOrder": [ "name" ], "description": "Removes an API product from an app's consumer key. After the API product is removed, the app cannot access the API resources defined in that API product. **Note**: The consumer key is not removed, only its association with the API product.", "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1AppGroupAppKey" }, "id": "apigee.organizations.appgroups.apps.keys.apiproducts.delete" }, "updateAppGroupAppKeyApiProduct": { "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/apps/{appsId}/keys/{keysId}/apiproducts/{apiproductsId}", "httpMethod": "POST", "parameters": { "action": { "location": "query", "type": "string", "description": "Approve or revoke the consumer key by setting this value to `approve` or `revoke` respectively. The `Content-Type` header, if set, must be set to `application/octet-stream`, with empty body." }, "name": { "type": "string", "description": "Required. Name of the API product in the developer app key in the following format: `organizations/{org}/appgroups/{app_group_name}/apps/{app}/keys/{key}/apiproducts/{apiproduct}`", "required": true, "location": "path", "pattern": "^organizations/[^/]+/appgroups/[^/]+/apps/[^/]+/keys/[^/]+/apiproducts/[^/]+$" } }, "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Approves or revokes the consumer key for an API product. After a consumer key is approved, the app can use it to access APIs. A consumer key that is revoked or pending cannot be used to access an API. Any access tokens associated with a revoked consumer key will remain active. However, Apigee checks the status of the consumer key and if set to `revoked` will not allow access to the API.", "parameterOrder": [ "name" ], "id": "apigee.organizations.appgroups.apps.keys.apiproducts.updateAppGroupAppKeyApiProduct", "path": "v1/{+name}" } } } }, "methods": { "get": { "description": "Gets details for a consumer key for a AppGroup app, including the key and secret value, associated API products, and other information.", "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/apps/{appsId}/keys/{keysId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1AppGroupAppKey" }, "parameters": { "name": { "description": "Required. Name of the AppGroup app key. Use the following structure in your request: `organizations/{org}/appgroups/{app_group_name}/apps/{app}/keys/{key}`", "pattern": "^organizations/[^/]+/appgroups/[^/]+/apps/[^/]+/keys/[^/]+$", "location": "path", "required": true, "type": "string" } }, "path": "v1/{+name}", "id": "apigee.organizations.appgroups.apps.keys.get", "parameterOrder": [ "name" ] }, "create": { "httpMethod": "POST", "parameters": { "parent": { "type": "string", "pattern": "^organizations/[^/]+/appgroups/[^/]+/apps/[^/]+$", "description": "Required. Parent of the AppGroup app key. Use the following structure in your request: `organizations/{org}/appgroups/{app_group_name}/apps/{app}/keys`", "location": "path", "required": true } }, "description": "Creates a custom consumer key and secret for a AppGroup app. This is particularly useful if you want to migrate existing consumer keys and secrets to Apigee from another system. Consumer keys and secrets can contain letters, numbers, underscores, and hyphens. No other special characters are allowed. To avoid service disruptions, a consumer key and secret should not exceed 2 KBs each. **Note**: When creating the consumer key and secret, an association to API products will not be made. Therefore, you should not specify the associated API products in your request. Instead, use the ProductizeAppGroupAppKey API to make the association after the consumer key and secret are created. If a consumer key and secret already exist, you can keep them or delete them using the DeleteAppGroupAppKey API.", "parameterOrder": [ "parent" ], "request": { "$ref": "GoogleCloudApigeeV1AppGroupAppKey" }, "response": { "$ref": "GoogleCloudApigeeV1AppGroupAppKey" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.appgroups.apps.keys.create", "path": "v1/{+parent}/keys", "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/apps/{appsId}/keys" }, "updateAppGroupAppKey": { "parameterOrder": [ "name" ], "httpMethod": "POST", "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudApigeeV1UpdateAppGroupAppKeyRequest" }, "id": "apigee.organizations.appgroups.apps.keys.updateAppGroupAppKey", "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/apps/{appsId}/keys/{keysId}", "description": "Adds an API product to an AppGroupAppKey, enabling the app that holds the key to access the API resources bundled in the API product. In addition, you can add attributes to the AppGroupAppKey. This API replaces the existing attributes with those specified in the request. Include or exclude any existing attributes that you want to retain or delete, respectively. You can use the same key to access all API products associated with the app.", "response": { "$ref": "GoogleCloudApigeeV1AppGroupAppKey" }, "parameters": { "name": { "required": true, "description": "Required. Name of the AppGroup app key. Use the following structure in your request: `organizations/{org}/appgroups/{app_group_name}/apps/{app}/keys/{key}`", "type": "string", "pattern": "^organizations/[^/]+/appgroups/[^/]+/apps/[^/]+/keys/[^/]+$", "location": "path" } } }, "delete": { "id": "apigee.organizations.appgroups.apps.keys.delete", "parameters": { "name": { "type": "string", "pattern": "^organizations/[^/]+/appgroups/[^/]+/apps/[^/]+/keys/[^/]+$", "description": "Required. Name of the AppGroup app key. Use the following structure in your request: `organizations/{org}/appgroups/{app_group_name}/apps/{app}/keys/{key}`", "required": true, "location": "path" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/apps/{appsId}/keys/{keysId}", "httpMethod": "DELETE", "path": "v1/{+name}", "description": "Deletes an app's consumer key and removes all API products associated with the app. After the consumer key is deleted, it cannot be used to access any APIs.", "response": { "$ref": "GoogleCloudApigeeV1AppGroupAppKey" } } } } } } }, "methods": { "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "parameters": { "name": { "pattern": "^organizations/[^/]+/appgroups/[^/]+$", "location": "path", "required": true, "description": "Required. Name of the AppGroup. Use the following structure in your request: `organizations/{org}/appgroups/{app_group_name}`", "type": "string" } }, "httpMethod": "DELETE", "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}", "id": "apigee.organizations.appgroups.delete", "response": { "$ref": "GoogleCloudApigeeV1AppGroup" }, "description": "Deletes an AppGroup. All app and API keys associations with the AppGroup are also removed. **Warning**: This API will permanently delete the AppGroup and related artifacts. **Note**: The delete operation is asynchronous. The AppGroup app is deleted immediately, but its associated resources, such as apps and API keys, may take anywhere from a few seconds to a few minutes to be deleted." }, "get": { "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "description": "Required. Name of the AppGroup. Use the following structure in your request: `organizations/{org}/appgroups/{app_group_name}`", "location": "path", "pattern": "^organizations/[^/]+/appgroups/[^/]+$", "type": "string", "required": true } }, "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}", "response": { "$ref": "GoogleCloudApigeeV1AppGroup" }, "description": "Returns the AppGroup details for the provided AppGroup name in the request URI.", "id": "apigee.organizations.appgroups.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "create": { "request": { "$ref": "GoogleCloudApigeeV1AppGroup" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Creates an AppGroup. Once created, user can register apps under the AppGroup to obtain secret key and password. At creation time, the AppGroup's state is set as `active`.", "id": "apigee.organizations.appgroups.create", "flatPath": "v1/organizations/{organizationsId}/appgroups", "parameterOrder": [ "parent" ], "parameters": { "parent": { "pattern": "^organizations/[^/]+$", "location": "path", "required": true, "description": "Required. Name of the Apigee organization in which the AppGroup is created. Use the following structure in your request: `organizations/{org}`.", "type": "string" } }, "httpMethod": "POST", "path": "v1/{+parent}/appgroups", "response": { "$ref": "GoogleCloudApigeeV1AppGroup" } }, "list": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "id": "apigee.organizations.appgroups.list", "flatPath": "v1/organizations/{organizationsId}/appgroups", "description": "Lists all AppGroups in an organization. A maximum of 1000 AppGroups are returned in the response if PageSize is not specified, or if the PageSize is greater than 1000.", "response": { "$ref": "GoogleCloudApigeeV1ListAppGroupsResponse" }, "parameterOrder": [ "parent" ], "path": "v1/{+parent}/appgroups", "parameters": { "filter": { "location": "query", "type": "string", "description": "The filter expression to be used to get the list of AppGroups, where filtering can be done on status, channelId or channelUri of the app group. Examples: filter=status=active\", filter=channelId=, filter=channelUri=" }, "parent": { "required": true, "type": "string", "description": "Required. Name of the Apigee organization. Use the following structure in your request: `organizations/{org}`.", "location": "path", "pattern": "^organizations/[^/]+$" }, "pageSize": { "format": "int32", "type": "integer", "location": "query", "description": "Count of AppGroups a single page can have in the response. If unspecified, at most 1000 AppGroups will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000." }, "pageToken": { "type": "string", "description": "The starting index record for listing the AppGroups.", "location": "query" } } }, "update": { "path": "v1/{+name}", "parameterOrder": [ "name" ], "request": { "$ref": "GoogleCloudApigeeV1AppGroup" }, "httpMethod": "PUT", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}", "parameters": { "action": { "type": "string", "description": "Activate or de-activate the AppGroup by setting the action as `active` or `inactive`. The `Content-Type` header must be set to `application/octet-stream`, with empty body.", "location": "query" }, "name": { "required": true, "location": "path", "description": "Required. Name of the AppGroup. Use the following structure in your request: `organizations/{org}/appgroups/{app_group_name}`", "pattern": "^organizations/[^/]+/appgroups/[^/]+$", "type": "string" } }, "id": "apigee.organizations.appgroups.update", "response": { "$ref": "GoogleCloudApigeeV1AppGroup" }, "description": "Updates an AppGroup. This API replaces the existing AppGroup details with those specified in the request. Include or exclude any existing details that you want to retain or delete, respectively. Note that the state of the AppGroup should be updated using `action`, and not via AppGroup." } } }, "datacollectors": { "methods": { "create": { "id": "apigee.organizations.datacollectors.create", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/datacollectors", "request": { "$ref": "GoogleCloudApigeeV1DataCollector" }, "flatPath": "v1/organizations/{organizationsId}/datacollectors", "description": "Creates a new data collector.", "response": { "$ref": "GoogleCloudApigeeV1DataCollector" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "dataCollectorId": { "location": "query", "type": "string", "description": "ID of the data collector. Overrides any ID in the data collector resource. Must be a string beginning with `dc_` that contains only letters, numbers, and underscores." }, "parent": { "description": "Required. Name of the organization in which to create the data collector in the following format: `organizations/{org}`.", "location": "path", "required": true, "pattern": "^organizations/[^/]+$", "type": "string" } }, "httpMethod": "POST" }, "list": { "path": "v1/{+parent}/datacollectors", "parameterOrder": [ "parent" ], "httpMethod": "GET", "description": "Lists all data collectors.", "parameters": { "parent": { "description": "Required. Name of the organization for which to list data collectors in the following format: `organizations/{org}`.", "required": true, "pattern": "^organizations/[^/]+$", "location": "path", "type": "string" }, "pageSize": { "type": "integer", "format": "int32", "location": "query", "description": "Maximum number of data collectors to return. The page size defaults to 25." }, "pageToken": { "type": "string", "location": "query", "description": "Page token, returned from a previous ListDataCollectors call, that you can use to retrieve the next page." } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.datacollectors.list", "flatPath": "v1/organizations/{organizationsId}/datacollectors", "response": { "$ref": "GoogleCloudApigeeV1ListDataCollectorsResponse" } }, "patch": { "id": "apigee.organizations.datacollectors.patch", "parameters": { "name": { "required": true, "pattern": "^organizations/[^/]+/datacollectors/[^/]+$", "type": "string", "location": "path", "description": "Required. Name of the data collector in the following format: `organizations/{org}/datacollectors/{data_collector_id}`." }, "updateMask": { "location": "query", "description": "List of fields to be updated.", "format": "google-fieldmask", "type": "string" } }, "httpMethod": "PATCH", "flatPath": "v1/organizations/{organizationsId}/datacollectors/{datacollectorsId}", "response": { "$ref": "GoogleCloudApigeeV1DataCollector" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Updates a data collector.", "path": "v1/{+name}", "request": { "$ref": "GoogleCloudApigeeV1DataCollector" }, "parameterOrder": [ "name" ] }, "get": { "id": "apigee.organizations.datacollectors.get", "parameterOrder": [ "name" ], "parameters": { "name": { "location": "path", "description": "Required. Name of the data collector in the following format: `organizations/{org}/datacollectors/{data_collector_id}`.", "pattern": "^organizations/[^/]+/datacollectors/[^/]+$", "type": "string", "required": true } }, "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/datacollectors/{datacollectorsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets a data collector.", "response": { "$ref": "GoogleCloudApigeeV1DataCollector" }, "path": "v1/{+name}" }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "httpMethod": "DELETE", "description": "Deletes a data collector.", "id": "apigee.organizations.datacollectors.delete", "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1/{+name}", "parameters": { "name": { "pattern": "^organizations/[^/]+/datacollectors/[^/]+$", "required": true, "type": "string", "description": "Required. Name of the data collector in the following format: `organizations/{org}/datacollectors/{data_collector_id}`.", "location": "path" } }, "flatPath": "v1/organizations/{organizationsId}/datacollectors/{datacollectorsId}" } } }, "apiproducts": { "resources": { "rateplans": { "methods": { "update": { "flatPath": "v1/organizations/{organizationsId}/apiproducts/{apiproductsId}/rateplans/{rateplansId}", "path": "v1/{+name}", "parameters": { "name": { "type": "string", "location": "path", "description": "Required. Name of the rate plan. Use the following structure in your request: `organizations/{org}/apiproducts/{apiproduct}/rateplans/{rateplan}`", "pattern": "^organizations/[^/]+/apiproducts/[^/]+/rateplans/[^/]+$", "required": true } }, "id": "apigee.organizations.apiproducts.rateplans.update", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "PUT", "request": { "$ref": "GoogleCloudApigeeV1RatePlan" }, "parameterOrder": [ "name" ], "description": "Updates an existing rate plan.", "response": { "$ref": "GoogleCloudApigeeV1RatePlan" } }, "delete": { "path": "v1/{+name}", "id": "apigee.organizations.apiproducts.rateplans.delete", "response": { "$ref": "GoogleCloudApigeeV1RatePlan" }, "flatPath": "v1/organizations/{organizationsId}/apiproducts/{apiproductsId}/rateplans/{rateplansId}", "description": "Deletes a rate plan.", "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "parameters": { "name": { "description": "Required. ID of the rate plan. Use the following structure in your request: `organizations/{org}/apiproducts/{apiproduct}/rateplans/{rateplan}`", "required": true, "location": "path", "type": "string", "pattern": "^organizations/[^/]+/apiproducts/[^/]+/rateplans/[^/]+$" } } }, "create": { "flatPath": "v1/organizations/{organizationsId}/apiproducts/{apiproductsId}/rateplans", "description": "Create a rate plan that is associated with an API product in an organization. Using rate plans, API product owners can monetize their API products by configuring one or more of the following: - Billing frequency - Initial setup fees for using an API product - Payment funding model (postpaid only) - Fixed recurring or consumption-based charges for using an API product - Revenue sharing with developer partners An API product can have multiple rate plans associated with it but *only one* rate plan can be active at any point of time. **Note: From the developer's perspective, they purchase API products not rate plans.", "response": { "$ref": "GoogleCloudApigeeV1RatePlan" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "parent": { "required": true, "type": "string", "pattern": "^organizations/[^/]+/apiproducts/[^/]+$", "description": "Required. Name of the API product that is associated with the rate plan. Use the following structure in your request: `organizations/{org}/apiproducts/{apiproduct}`", "location": "path" } }, "parameterOrder": [ "parent" ], "request": { "$ref": "GoogleCloudApigeeV1RatePlan" }, "path": "v1/{+parent}/rateplans", "id": "apigee.organizations.apiproducts.rateplans.create" }, "list": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/apiproducts/{apiproductsId}/rateplans", "parameterOrder": [ "parent" ], "parameters": { "orderBy": { "location": "query", "description": "Name of the attribute used for sorting. Valid values include: * `name`: Name of the rate plan. * `state`: State of the rate plan (`DRAFT`, `PUBLISHED`). * `startTime`: Time when the rate plan becomes active. * `endTime`: Time when the rate plan expires. **Note**: Not supported by Apigee at this time.", "type": "string" }, "expand": { "description": "Flag that specifies whether to expand the results. Set to `true` to get expanded details about each API. Defaults to `false`.", "type": "boolean", "location": "query" }, "state": { "enum": [ "STATE_UNSPECIFIED", "DRAFT", "PUBLISHED" ], "description": "State of the rate plans (`DRAFT`, `PUBLISHED`) that you want to display.", "enumDescriptions": [ "State of the rate plan is not specified.", "Rate plan is in draft mode and only visible to API providers.", "Rate plan is published and will become visible to developers for the configured duration (between `startTime` and `endTime`)." ], "type": "string", "location": "query" }, "startKey": { "type": "string", "location": "query", "description": "Name of the rate plan from which to start displaying the list of rate plans. If omitted, the list starts from the first item. For example, to view the rate plans from 51-150, set the value of `startKey` to the name of the 51st rate plan and set the value of `count` to 100." }, "count": { "location": "query", "description": "Number of rate plans to return in the API call. Use with the `startKey` parameter to provide more targeted filtering. The maximum limit is 1000. Defaults to 100.", "type": "integer", "format": "int32" }, "parent": { "type": "string", "pattern": "^organizations/[^/]+/apiproducts/[^/]+$", "location": "path", "description": "Required. Name of the API product. Use the following structure in your request: `organizations/{org}/apiproducts/{apiproduct}` Use `organizations/{org}/apiproducts/-` to return rate plans for all API products within the organization.", "required": true } }, "path": "v1/{+parent}/rateplans", "response": { "$ref": "GoogleCloudApigeeV1ListRatePlansResponse" }, "description": "Lists all the rate plans for an API product.", "httpMethod": "GET", "id": "apigee.organizations.apiproducts.rateplans.list" }, "get": { "flatPath": "v1/organizations/{organizationsId}/apiproducts/{apiproductsId}/rateplans/{rateplansId}", "description": "Gets the details of a rate plan.", "httpMethod": "GET", "parameters": { "name": { "description": "Required. Name of the rate plan. Use the following structure in your request: `organizations/{org}/apiproducts/{apiproduct}/rateplans/{rateplan}`", "pattern": "^organizations/[^/]+/apiproducts/[^/]+/rateplans/[^/]+$", "required": true, "type": "string", "location": "path" } }, "id": "apigee.organizations.apiproducts.rateplans.get", "path": "v1/{+name}", "response": { "$ref": "GoogleCloudApigeeV1RatePlan" }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } }, "attributes": { "methods": { "updateApiProductAttribute": { "path": "v1/{+name}", "response": { "$ref": "GoogleCloudApigeeV1Attribute" }, "flatPath": "v1/organizations/{organizationsId}/apiproducts/{apiproductsId}/attributes/{attributesId}", "httpMethod": "POST", "parameters": { "name": { "pattern": "^organizations/[^/]+/apiproducts/[^/]+/attributes/[^/]+$", "description": "Required. Name of the API product. Use the following structure in your request: `organizations/{org}/apiproducts/{apiproduct}`", "location": "path", "required": true, "type": "string" } }, "request": { "$ref": "GoogleCloudApigeeV1Attribute" }, "description": "Updates the value of an API product attribute. **Note**: OAuth access tokens and Key Management Service (KMS) entities (apps, developers, and API products) are cached for 180 seconds (current default). Any custom attributes associated with entities also get cached for at least 180 seconds after entity is accessed during runtime. In this case, the `ExpiresIn` element on the OAuthV2 policy won't be able to expire an access token in less than 180 seconds.", "id": "apigee.organizations.apiproducts.attributes.updateApiProductAttribute", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "id": "apigee.organizations.apiproducts.attributes.delete", "description": "Deletes an API product attribute.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/apiproducts/{apiproductsId}/attributes/{attributesId}", "parameters": { "name": { "description": "Required. Name of the API product attribute. Use the following structure in your request: `organizations/{org}/apiproducts/{apiproduct}/attributes/{attribute}`", "location": "path", "pattern": "^organizations/[^/]+/apiproducts/[^/]+/attributes/[^/]+$", "type": "string", "required": true } }, "path": "v1/{+name}", "httpMethod": "DELETE", "response": { "$ref": "GoogleCloudApigeeV1Attribute" }, "parameterOrder": [ "name" ] }, "get": { "httpMethod": "GET", "parameters": { "name": { "pattern": "^organizations/[^/]+/apiproducts/[^/]+/attributes/[^/]+$", "location": "path", "type": "string", "required": true, "description": "Required. Name of the API product attribute. Use the following structure in your request: `organizations/{org}/apiproducts/{apiproduct}/attributes/{attribute}`" } }, "path": "v1/{+name}", "description": "Gets the value of an API product attribute.", "flatPath": "v1/organizations/{organizationsId}/apiproducts/{apiproductsId}/attributes/{attributesId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1Attribute" }, "id": "apigee.organizations.apiproducts.attributes.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "httpMethod": "GET", "id": "apigee.organizations.apiproducts.attributes.list", "parameters": { "parent": { "type": "string", "pattern": "^organizations/[^/]+/apiproducts/[^/]+$", "description": "Required. Name of the API product. Use the following structure in your request: `organizations/{org}/apiproducts/{apiproduct}`", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists all API product attributes.", "response": { "$ref": "GoogleCloudApigeeV1Attributes" }, "flatPath": "v1/organizations/{organizationsId}/apiproducts/{apiproductsId}/attributes", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/attributes" } } } }, "methods": { "create": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudApigeeV1ApiProduct" }, "id": "apigee.organizations.apiproducts.create", "parameterOrder": [ "parent" ], "parameters": { "parent": { "required": true, "description": "Required. Name of the organization in which the API product will be created. Use the following structure in your request: `organizations/{org}`", "type": "string", "pattern": "^organizations/[^/]+$", "location": "path" } }, "response": { "$ref": "GoogleCloudApigeeV1ApiProduct" }, "httpMethod": "POST", "flatPath": "v1/organizations/{organizationsId}/apiproducts", "path": "v1/{+parent}/apiproducts", "description": "Creates an API product in an organization. You create API products after you have proxied backend services using API proxies. An API product is a collection of API resources combined with quota settings and metadata that you can use to deliver customized and productized API bundles to your developer community. This metadata can include: - Scope - Environments - API proxies - Extensible profile API products enable you repackage APIs on the fly, without having to do any additional coding or configuration. Apigee recommends that you start with a simple API product including only required elements. You then provision credentials to apps to enable them to start testing your APIs. After you have authentication and authorization working against a simple API product, you can iterate to create finer-grained API products, defining different sets of API resources for each API product. **WARNING:** - If you don't specify an API proxy in the request body, *any* app associated with the product can make calls to *any* API in your entire organization. - If you don't specify an environment in the request body, the product allows access to all environments. For more information, see What is an API product?" }, "update": { "description": "Updates an existing API product. You must include all required values, whether or not you are updating them, as well as any optional values that you are updating. The API product name required in the request URL is the internal name of the product, not the display name. While they may be the same, it depends on whether the API product was created via UI or API. View the list of API products to identify their internal names.", "flatPath": "v1/organizations/{organizationsId}/apiproducts/{apiproductsId}", "id": "apigee.organizations.apiproducts.update", "parameterOrder": [ "name" ], "path": "v1/{+name}", "parameters": { "name": { "pattern": "^organizations/[^/]+/apiproducts/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. Name of the API product. Use the following structure in your request: `organizations/{org}/apiproducts/{apiproduct}`" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "PUT", "response": { "$ref": "GoogleCloudApigeeV1ApiProduct" }, "request": { "$ref": "GoogleCloudApigeeV1ApiProduct" } }, "get": { "id": "apigee.organizations.apiproducts.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1ApiProduct" }, "parameters": { "name": { "required": true, "location": "path", "pattern": "^organizations/[^/]+/apiproducts/[^/]+$", "description": "Required. Name of the API product. Use the following structure in your request: `organizations/{org}/apiproducts/{apiproduct}`", "type": "string" } }, "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/apiproducts/{apiproductsId}", "description": "Gets configuration details for an API product. The API product name required in the request URL is the internal name of the product, not the display name. While they may be the same, it depends on whether the API product was created via the UI or the API. View the list of API products to verify the internal name.", "path": "v1/{+name}" }, "list": { "path": "v1/{+parent}/apiproducts", "response": { "$ref": "GoogleCloudApigeeV1ListApiProductsResponse" }, "flatPath": "v1/organizations/{organizationsId}/apiproducts", "parameterOrder": [ "parent" ], "description": "Lists all API product names for an organization. Filter the list by passing an `attributename` and `attibutevalue`. The maximum number of API products returned is 1000. You can paginate the list of API products returned using the `startKey` and `count` query parameters.", "id": "apigee.organizations.apiproducts.list", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "attributevalue": { "description": "Value of the attribute used to filter the search.", "location": "query", "type": "string" }, "expand": { "location": "query", "type": "boolean", "description": "Flag that specifies whether to expand the results. Set to `true` to get expanded details about each API." }, "startKey": { "description": "Gets a list of API products starting with a specific API product in the list. For example, if you're returning 50 API products at a time (using the `count` query parameter), you can view products 50-99 by entering the name of the 50th API product in the first API (without using `startKey`). Product name is case sensitive.", "location": "query", "type": "string" }, "attributename": { "type": "string", "location": "query", "description": "Name of the attribute used to filter the search." }, "parent": { "pattern": "^organizations/[^/]+$", "description": "Required. Name of the organization. Use the following structure in your request: `organizations/{org}`", "location": "path", "required": true, "type": "string" }, "count": { "type": "string", "format": "int64", "location": "query", "description": "Enter the number of API products you want returned in the API call. The limit is 1000." } }, "httpMethod": "GET" }, "attributes": { "parameters": { "name": { "required": true, "pattern": "^organizations/[^/]+/apiproducts/[^/]+$", "type": "string", "description": "Required. Name of the API product. Use the following structure in your request: `organizations/{org}/apiproducts/{apiproduct}`", "location": "path" } }, "httpMethod": "POST", "description": "Updates or creates API product attributes. This API **replaces** the current list of attributes with the attributes specified in the request body. In this way, you can update existing attributes, add new attributes, or delete existing attributes by omitting them from the request body. **Note**: OAuth access tokens and Key Management Service (KMS) entities (apps, developers, and API products) are cached for 180 seconds (current default). Any custom attributes associated with entities also get cached for at least 180 seconds after entity is accessed during runtime. In this case, the `ExpiresIn` element on the OAuthV2 policy won't be able to expire an access token in less than 180 seconds.", "id": "apigee.organizations.apiproducts.attributes", "flatPath": "v1/organizations/{organizationsId}/apiproducts/{apiproductsId}/attributes", "parameterOrder": [ "name" ], "request": { "$ref": "GoogleCloudApigeeV1Attributes" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}/attributes", "response": { "$ref": "GoogleCloudApigeeV1Attributes" } }, "delete": { "path": "v1/{+name}", "response": { "$ref": "GoogleCloudApigeeV1ApiProduct" }, "parameterOrder": [ "name" ], "id": "apigee.organizations.apiproducts.delete", "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/apiproducts/{apiproductsId}", "description": "Deletes an API product from an organization. Deleting an API product causes app requests to the resource URIs defined in the API product to fail. Ensure that you create a new API product to serve existing apps, unless your intention is to disable access to the resources defined in the API product. The API product name required in the request URL is the internal name of the product, not the display name. While they may be the same, it depends on whether the API product was created via the UI or the API. View the list of API products to verify the internal name.", "parameters": { "name": { "location": "path", "pattern": "^organizations/[^/]+/apiproducts/[^/]+$", "required": true, "description": "Required. Name of the API product. Use the following structure in your request: `organizations/{org}/apiproducts/{apiproduct}`", "type": "string" } } } } }, "envgroups": { "resources": { "attachments": { "methods": { "get": { "response": { "$ref": "GoogleCloudApigeeV1EnvironmentGroupAttachment" }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.envgroups.attachments.get", "description": "Gets an environment group attachment.", "parameterOrder": [ "name" ], "parameters": { "name": { "pattern": "^organizations/[^/]+/envgroups/[^/]+/attachments/[^/]+$", "required": true, "location": "path", "description": "Required. Name of the environment group attachment in the following format: `organizations/{org}/envgroups/{envgroup}/attachments/{attachment}`", "type": "string" } }, "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/envgroups/{envgroupsId}/attachments/{attachmentsId}" }, "create": { "parameters": { "parent": { "location": "path", "required": true, "description": "Required. EnvironmentGroup under which to create the attachment in the following format: `organizations/{org}/envgroups/{envgroup}`.", "type": "string", "pattern": "^organizations/[^/]+/envgroups/[^/]+$" } }, "path": "v1/{+parent}/attachments", "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "POST", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudApigeeV1EnvironmentGroupAttachment" }, "flatPath": "v1/organizations/{organizationsId}/envgroups/{envgroupsId}/attachments", "id": "apigee.organizations.envgroups.attachments.create", "description": "Creates a new attachment of an environment to an environment group." }, "delete": { "httpMethod": "DELETE", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1/{+name}", "description": "Deletes an environment group attachment.", "flatPath": "v1/organizations/{organizationsId}/envgroups/{envgroupsId}/attachments/{attachmentsId}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "type": "string", "pattern": "^organizations/[^/]+/envgroups/[^/]+/attachments/[^/]+$", "required": true, "description": "Required. Name of the environment group attachment to delete in the following format: `organizations/{org}/envgroups/{envgroup}/attachments/{attachment}`." } }, "id": "apigee.organizations.envgroups.attachments.delete" }, "list": { "description": "Lists all attachments of an environment group.", "id": "apigee.organizations.envgroups.attachments.list", "parameters": { "pageSize": { "description": "Maximum number of environment group attachments to return. The page size defaults to 25.", "format": "int32", "type": "integer", "location": "query" }, "parent": { "required": true, "description": "Required. Name of the environment group in the following format: `organizations/{org}/envgroups/{envgroup}`.", "pattern": "^organizations/[^/]+/envgroups/[^/]+$", "type": "string", "location": "path" }, "pageToken": { "type": "string", "description": "Page token, returned by a previous ListEnvironmentGroupAttachments call, that you can use to retrieve the next page.", "location": "query" } }, "httpMethod": "GET", "path": "v1/{+parent}/attachments", "flatPath": "v1/organizations/{organizationsId}/envgroups/{envgroupsId}/attachments", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ListEnvironmentGroupAttachmentsResponse" } } } } }, "methods": { "getDeployedIngressConfig": { "parameterOrder": [ "name" ], "id": "apigee.organizations.envgroups.getDeployedIngressConfig", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "response": { "$ref": "GoogleCloudApigeeV1EnvironmentGroupConfig" }, "flatPath": "v1/organizations/{organizationsId}/envgroups/{envgroupsId}/deployedIngressConfig", "path": "v1/{+name}", "parameters": { "view": { "enum": [ "INGRESS_CONFIG_VIEW_UNSPECIFIED", "BASIC", "FULL" ], "location": "query", "description": "When set to FULL, additional details about the specific deployments receiving traffic will be included in the IngressConfig response's RoutingRules.", "type": "string", "enumDescriptions": [ "The default/unset value. The API will default to the BASIC view.", "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.", "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." ] }, "name": { "required": true, "description": "Required. Name of the deployed configuration for the environment group in the following format: 'organizations/{org}/envgroups/{envgroup}/deployedIngressConfig'.", "type": "string", "location": "path", "pattern": "^organizations/[^/]+/envgroups/[^/]+/deployedIngressConfig$" } }, "description": "Gets the deployed ingress configuration for an environment group." }, "get": { "flatPath": "v1/organizations/{organizationsId}/envgroups/{envgroupsId}", "description": "Gets an environment group.", "id": "apigee.organizations.envgroups.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1EnvironmentGroup" }, "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "required": true, "description": "Required. Name of the environment group in the following format: `organizations/{org}/envgroups/{envgroup}`.", "pattern": "^organizations/[^/]+/envgroups/[^/]+$", "location": "path" } }, "httpMethod": "GET", "path": "v1/{+name}" }, "list": { "path": "v1/{+parent}/envgroups", "flatPath": "v1/organizations/{organizationsId}/envgroups", "parameterOrder": [ "parent" ], "id": "apigee.organizations.envgroups.list", "description": "Lists all environment groups.", "response": { "$ref": "GoogleCloudApigeeV1ListEnvironmentGroupsResponse" }, "parameters": { "pageToken": { "type": "string", "location": "query", "description": "Page token, returned from a previous ListEnvironmentGroups call, that you can use to retrieve the next page." }, "parent": { "pattern": "^organizations/[^/]+$", "description": "Required. Name of the organization for which to list environment groups in the following format: `organizations/{org}`.", "required": true, "location": "path", "type": "string" }, "pageSize": { "format": "int32", "type": "integer", "description": "Maximum number of environment groups to return. The page size defaults to 25.", "location": "query" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET" }, "delete": { "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.envgroups.delete", "description": "Deletes an environment group.", "flatPath": "v1/organizations/{organizationsId}/envgroups/{envgroupsId}", "parameters": { "name": { "description": "Required. Name of the environment group in the following format: `organizations/{org}/envgroups/{envgroup}`.", "pattern": "^organizations/[^/]+/envgroups/[^/]+$", "location": "path", "type": "string", "required": true } }, "path": "v1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ] }, "create": { "flatPath": "v1/organizations/{organizationsId}/envgroups", "description": "Creates a new environment group.", "parameterOrder": [ "parent" ], "request": { "$ref": "GoogleCloudApigeeV1EnvironmentGroup" }, "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "POST", "id": "apigee.organizations.envgroups.create", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "Optional. ID of the environment group. Overrides any ID in the environment_group resource.", "type": "string", "location": "query" }, "parent": { "description": "Required. Name of the organization in which to create the environment group in the following format: `organizations/{org}`.", "location": "path", "required": true, "pattern": "^organizations/[^/]+$", "type": "string" } }, "path": "v1/{+parent}/envgroups" }, "patch": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Updates an environment group.", "id": "apigee.organizations.envgroups.patch", "path": "v1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" }, "request": { "$ref": "GoogleCloudApigeeV1EnvironmentGroup" }, "parameters": { "name": { "pattern": "^organizations/[^/]+/envgroups/[^/]+$", "required": true, "description": "Required. Name of the environment group to update in the format: `organizations/{org}/envgroups/{envgroup}.", "location": "path", "type": "string" }, "updateMask": { "description": "Optional. List of fields to be updated.", "format": "google-fieldmask", "location": "query", "type": "string" } }, "httpMethod": "PATCH", "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/envgroups/{envgroupsId}" } } }, "deployments": { "methods": { "list": { "response": { "$ref": "GoogleCloudApigeeV1ListDeploymentsResponse" }, "parameters": { "sharedFlows": { "type": "boolean", "description": "Optional. Flag that specifies whether to return shared flow or API proxy deployments. Set to `true` to return shared flow deployments; set to `false` to return API proxy deployments. Defaults to `false`.", "location": "query" }, "parent": { "location": "path", "description": "Required. Name of the organization for which to return deployment information in the following format: `organizations/{org}`", "type": "string", "required": true, "pattern": "^organizations/[^/]+$" } }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/deployments", "id": "apigee.organizations.deployments.list", "description": "Lists all deployments of API proxies or shared flows.", "path": "v1/{+parent}/deployments", "httpMethod": "GET" } } }, "apis": { "methods": { "list": { "response": { "$ref": "GoogleCloudApigeeV1ListApiProxiesResponse" }, "path": "v1/{+parent}/apis", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.apis.list", "description": "Lists the names of all API proxies in an organization. The names returned correspond to the names defined in the configuration files for each API proxy.", "parameterOrder": [ "parent" ], "flatPath": "v1/organizations/{organizationsId}/apis", "parameters": { "includeMetaData": { "type": "boolean", "description": "Flag that specifies whether to include API proxy metadata in the response.", "location": "query" }, "parent": { "description": "Required. Name of the organization in the following format: `organizations/{org}`", "required": true, "type": "string", "location": "path", "pattern": "^organizations/[^/]+$" }, "includeRevisions": { "location": "query", "description": "Flag that specifies whether to include a list of revisions in the response.", "type": "boolean" } } }, "patch": { "description": "Updates an existing API proxy.", "response": { "$ref": "GoogleCloudApigeeV1ApiProxy" }, "parameterOrder": [ "name" ], "httpMethod": "PATCH", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "required": true, "pattern": "^organizations/[^/]+/apis/[^/]+$", "location": "path", "description": "Required. API proxy to update in the following format: `organizations/{org}/apis/{api}`", "type": "string" }, "updateMask": { "description": "Required. The list of fields to update.", "type": "string", "location": "query", "format": "google-fieldmask" } }, "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}", "id": "apigee.organizations.apis.patch", "path": "v1/{+name}", "request": { "$ref": "GoogleCloudApigeeV1ApiProxy" } }, "delete": { "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}", "httpMethod": "DELETE", "description": "Deletes an API proxy and all associated endpoints, policies, resources, and revisions. The API proxy must be undeployed before you can delete it.", "id": "apigee.organizations.apis.delete", "parameters": { "name": { "location": "path", "required": true, "description": "Required. Name of the API proxy in the following format: `organizations/{org}/apis/{api}`", "pattern": "^organizations/[^/]+/apis/[^/]+$", "type": "string" } }, "response": { "$ref": "GoogleCloudApigeeV1ApiProxy" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "parameterOrder": [ "name" ] }, "create": { "parameters": { "parent": { "type": "string", "location": "path", "description": "Required. Name of the organization in the following format: `organizations/{org}`", "required": true, "pattern": "^organizations/[^/]+$" }, "action": { "description": "Action to perform when importing an API proxy configuration bundle. Set this parameter to one of the following values: * `import` to import the API proxy configuration bundle. * `validate` to validate the API proxy configuration bundle without importing it.", "type": "string", "location": "query" }, "name": { "description": "Name of the API proxy. Restrict the characters used to: A-Za-z0-9._-", "location": "query", "type": "string" }, "validate": { "type": "boolean", "description": "Ignored. All uploads are validated regardless of the value of this field. Maintained for compatibility with Apigee Edge API.", "location": "query" } }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1ApiProxyRevision" }, "path": "v1/{+parent}/apis", "id": "apigee.organizations.apis.create", "description": "Creates an API proxy. The API proxy created will not be accessible at runtime until it is deployed to an environment. Create a new API proxy by setting the `name` query parameter to the name of the API proxy. Import an API proxy configuration bundle stored in zip format on your local machine to your organization by doing the following: * Set the `name` query parameter to the name of the API proxy. * Set the `action` query parameter to `import`. * Set the `Content-Type` header to `multipart/form-data`. * Pass as a file the name of API proxy configuration bundle stored in zip format on your local machine using the `file` form field. **Note**: To validate the API proxy configuration bundle only without importing it, set the `action` query parameter to `validate`. When importing an API proxy configuration bundle, if the API proxy does not exist, it will be created. If the API proxy exists, then a new revision is created. Invalid API proxy configurations are rejected, and a list of validation errors is returned to the client.", "request": { "$ref": "GoogleApiHttpBody" }, "httpMethod": "POST", "flatPath": "v1/organizations/{organizationsId}/apis" }, "get": { "path": "v1/{+name}", "description": "Gets an API proxy including a list of existing revisions.", "response": { "$ref": "GoogleCloudApigeeV1ApiProxy" }, "parameterOrder": [ "name" ], "parameters": { "name": { "pattern": "^organizations/[^/]+/apis/[^/]+$", "required": true, "location": "path", "description": "Required. Name of the API proxy in the following format: `organizations/{org}/apis/{api}`", "type": "string" } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.apis.get", "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}" } }, "resources": { "deployments": { "methods": { "list": { "response": { "$ref": "GoogleCloudApigeeV1ListDeploymentsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists all deployments of an API proxy.", "path": "v1/{+parent}/deployments", "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/deployments", "httpMethod": "GET", "parameterOrder": [ "parent" ], "id": "apigee.organizations.apis.deployments.list", "parameters": { "parent": { "type": "string", "location": "path", "required": true, "pattern": "^organizations/[^/]+/apis/[^/]+$", "description": "Required. Name of the API proxy for which to return deployment information in the following format: `organizations/{org}/apis/{api}`" } } } } }, "keyvaluemaps": { "methods": { "create": { "response": { "$ref": "GoogleCloudApigeeV1KeyValueMap" }, "httpMethod": "POST", "description": "Creates a key value map in an API proxy.", "parameterOrder": [ "parent" ], "parameters": { "parent": { "pattern": "^organizations/[^/]+/apis/[^/]+$", "description": "Required. Name of the environment in which to create the key value map. Use the following structure in your request: `organizations/{org}/apis/{api}`", "type": "string", "location": "path", "required": true } }, "request": { "$ref": "GoogleCloudApigeeV1KeyValueMap" }, "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/keyvaluemaps", "id": "apigee.organizations.apis.keyvaluemaps.create", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+parent}/keyvaluemaps" }, "delete": { "id": "apigee.organizations.apis.keyvaluemaps.delete", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "pattern": "^organizations/[^/]+/apis/[^/]+/keyvaluemaps/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. Name of the key value map. Use the following structure in your request: `organizations/{org}/apis/{api}/keyvaluemaps/{keyvaluemap}`" } }, "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/keyvaluemaps/{keyvaluemapsId}", "description": "Deletes a key value map from an API proxy.", "httpMethod": "DELETE", "path": "v1/{+name}", "response": { "$ref": "GoogleCloudApigeeV1KeyValueMap" } } }, "resources": { "entries": { "methods": { "list": { "response": { "$ref": "GoogleCloudApigeeV1ListKeyValueEntriesResponse" }, "path": "v1/{+parent}/entries", "parameterOrder": [ "parent" ], "description": "Lists key value entries for key values maps scoped to an organization, environment, or API proxy. **Note**: Supported for Apigee hybrid 1.8.x and higher.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/keyvaluemaps/{keyvaluemapsId}/entries", "parameters": { "parent": { "description": "Required. Scope as indicated by the URI in which to list key value maps. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", "location": "path", "required": true, "pattern": "^organizations/[^/]+/apis/[^/]+/keyvaluemaps/[^/]+$", "type": "string" }, "pageSize": { "type": "integer", "location": "query", "format": "int32", "description": "Optional. Maximum number of key value entries to return. If unspecified, at most 100 entries will be returned." }, "pageToken": { "type": "string", "location": "query", "description": "Optional. Page token. If provides, must be a valid key value entry returned from a previous call that can be used to retrieve the next page." } }, "id": "apigee.organizations.apis.keyvaluemaps.entries.list", "httpMethod": "GET" }, "update": { "response": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "request": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "PUT", "parameterOrder": [ "name" ], "description": "Update key value entry scoped to an organization, environment, or API proxy for an existing key.", "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}", "id": "apigee.organizations.apis.keyvaluemaps.entries.update", "path": "v1/{+name}", "parameters": { "name": { "description": "Required. Scope as indicated by the URI in which to create the key value map entry. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", "required": true, "location": "path", "pattern": "^organizations/[^/]+/apis/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$", "type": "string" } } }, "delete": { "httpMethod": "DELETE", "description": "Deletes a key value entry from a key value map scoped to an organization, environment, or API proxy. **Notes:** * After you delete the key value entry, the policy consuming the entry will continue to function with its cached values for a few minutes. This is expected behavior. * Supported for Apigee hybrid 1.8.x and higher.", "path": "v1/{+name}", "id": "apigee.organizations.apis.keyvaluemaps.entries.delete", "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "parameters": { "name": { "required": true, "description": "Required. Scope as indicated by the URI in which to delete the key value map entry. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`.", "location": "path", "pattern": "^organizations/[^/]+/apis/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$", "type": "string" } } }, "create": { "description": "Creates key value entries in a key value map scoped to an organization, environment, or API proxy. **Note**: Supported for Apigee hybrid 1.8.x and higher.", "parameters": { "parent": { "pattern": "^organizations/[^/]+/apis/[^/]+/keyvaluemaps/[^/]+$", "description": "Required. Scope as indicated by the URI in which to create the key value map entry. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", "type": "string", "required": true, "location": "path" } }, "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/keyvaluemaps/{keyvaluemapsId}/entries", "path": "v1/{+parent}/entries", "id": "apigee.organizations.apis.keyvaluemaps.entries.create", "response": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "request": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "httpMethod": "POST" }, "get": { "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}", "response": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "path": "v1/{+name}", "parameterOrder": [ "name" ], "parameters": { "name": { "required": true, "pattern": "^organizations/[^/]+/apis/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$", "type": "string", "location": "path", "description": "Required. Scope as indicated by the URI in which to fetch the key value map entry/value. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`." } }, "httpMethod": "GET", "id": "apigee.organizations.apis.keyvaluemaps.entries.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Get the key value entry value for a key value map scoped to an organization, environment, or API proxy. **Note**: Supported for Apigee hybrid 1.8.x and higher." } } } } }, "revisions": { "methods": { "delete": { "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1ApiProxyRevision" }, "parameterOrder": [ "name" ], "parameters": { "name": { "description": "Required. API proxy revision in the following format: `organizations/{org}/apis/{api}/revisions/{rev}`", "location": "path", "required": true, "pattern": "^organizations/[^/]+/apis/[^/]+/revisions/[^/]+$", "type": "string" } }, "description": "Deletes an API proxy revision and all policies, resources, endpoints, and revisions associated with it. The API proxy revision must be undeployed before you can delete it.", "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/revisions/{revisionsId}", "id": "apigee.organizations.apis.revisions.delete", "path": "v1/{+name}" }, "get": { "path": "v1/{+name}", "response": { "$ref": "GoogleApiHttpBody" }, "httpMethod": "GET", "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/revisions/{revisionsId}", "parameters": { "format": { "description": "Format used when downloading the API proxy configuration revision. Set to `bundle` to download the API proxy configuration revision as a zip file.", "location": "query", "type": "string" }, "name": { "location": "path", "type": "string", "required": true, "description": "Required. API proxy revision in the following format: `organizations/{org}/apis/{api}/revisions/{rev}`", "pattern": "^organizations/[^/]+/apis/[^/]+/revisions/[^/]+$" } }, "id": "apigee.organizations.apis.revisions.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets an API proxy revision. To download the API proxy configuration bundle for the specified revision as a zip file, set the `format` query parameter to `bundle`. If you are using curl, specify `-o filename.zip` to save the output to a file; otherwise, it displays to `stdout`. Then, develop the API proxy configuration locally and upload the updated API proxy configuration revision, as described in [updateApiProxyRevision](updateApiProxyRevision)." }, "updateApiProxyRevision": { "parameters": { "validate": { "location": "query", "description": "Ignored. All uploads are validated regardless of the value of this field. Maintained for compatibility with Apigee Edge API.", "type": "boolean" }, "name": { "type": "string", "description": "Required. API proxy revision to update in the following format: `organizations/{org}/apis/{api}/revisions/{rev}`", "pattern": "^organizations/[^/]+/apis/[^/]+/revisions/[^/]+$", "required": true, "location": "path" } }, "parameterOrder": [ "name" ], "id": "apigee.organizations.apis.revisions.updateApiProxyRevision", "path": "v1/{+name}", "description": "Updates an existing API proxy revision by uploading the API proxy configuration bundle as a zip file from your local machine. You can update only API proxy revisions that have never been deployed. After deployment, an API proxy revision becomes immutable, even if it is undeployed. Set the `Content-Type` header to either `multipart/form-data` or `application/octet-stream`.", "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/revisions/{revisionsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1ApiProxyRevision" }, "httpMethod": "POST", "request": { "$ref": "GoogleApiHttpBody" } } }, "resources": { "deployments": { "methods": { "list": { "parameterOrder": [ "parent" ], "description": "Lists all deployments of an API proxy revision.", "parameters": { "parent": { "type": "string", "pattern": "^organizations/[^/]+/apis/[^/]+/revisions/[^/]+$", "required": true, "description": "Required. Name of the API proxy revision for which to return deployment information in the following format: `organizations/{org}/apis/{api}/revisions/{rev}`.", "location": "path" } }, "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/revisions/{revisionsId}/deployments", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "response": { "$ref": "GoogleCloudApigeeV1ListDeploymentsResponse" }, "id": "apigee.organizations.apis.revisions.deployments.list", "path": "v1/{+parent}/deployments" } } } } } } }, "hostSecurityReports": { "methods": { "get": { "httpMethod": "GET", "id": "apigee.organizations.hostSecurityReports.get", "response": { "$ref": "GoogleCloudApigeeV1SecurityReport" }, "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "parameters": { "name": { "description": "Required. Name of the security report to get. Must be of the form `organizations/{org}/securityReports/{reportId}`.", "pattern": "^organizations/[^/]+/hostSecurityReports/[^/]+$", "required": true, "location": "path", "type": "string" } }, "flatPath": "v1/organizations/{organizationsId}/hostSecurityReports/{hostSecurityReportsId}", "description": "Get status of a query submitted at host level. If the query is still in progress, the `state` is set to \"running\" After the query has completed successfully, `state` is set to \"completed\"" }, "getResultView": { "response": { "$ref": "GoogleCloudApigeeV1SecurityReportResultView" }, "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/hostSecurityReports/{hostSecurityReportsId}/resultView", "id": "apigee.organizations.hostSecurityReports.getResultView", "description": "After the query is completed, use this API to view the query result when result size is small.", "httpMethod": "GET", "parameters": { "name": { "location": "path", "type": "string", "pattern": "^organizations/[^/]+/hostSecurityReports/[^/]+/resultView$", "required": true, "description": "Required. Name of the security report result view to get. Must be of the form `organizations/{org}/securityReports/{reportId}/resultView`." } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "getResult": { "description": "After the query is completed, use this API to retrieve the results. If the request succeeds, and there is a non-zero result set, the result is downloaded to the client as a zipped JSON file. The name of the downloaded file will be: OfflineQueryResult-.zip Example: `OfflineQueryResult-9cfc0d85-0f30-46d6-ae6f-318d0cb961bd.zip`", "flatPath": "v1/organizations/{organizationsId}/hostSecurityReports/{hostSecurityReportsId}/result", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleApiHttpBody" }, "id": "apigee.organizations.hostSecurityReports.getResult", "parameterOrder": [ "name" ], "parameters": { "name": { "pattern": "^organizations/[^/]+/hostSecurityReports/[^/]+/result$", "required": true, "type": "string", "description": "Required. Name of the security report result to get. Must be of the form `organizations/{org}/securityReports/{reportId}/result`.", "location": "path" } }, "path": "v1/{+name}" }, "create": { "parameterOrder": [ "parent" ], "request": { "$ref": "GoogleCloudApigeeV1SecurityReportQuery" }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Submit a query at host level to be processed in the background. If the submission of the query succeeds, the API returns a 201 status and an ID that refer to the query. In addition to the HTTP status 201, the `state` of \"enqueued\" means that the request succeeded.", "response": { "$ref": "GoogleCloudApigeeV1SecurityReport" }, "id": "apigee.organizations.hostSecurityReports.create", "path": "v1/{+parent}/hostSecurityReports", "parameters": { "parent": { "description": "Required. The parent resource name. Must be of the form `organizations/{org}`.", "pattern": "^organizations/[^/]+$", "type": "string", "location": "path", "required": true } }, "flatPath": "v1/organizations/{organizationsId}/hostSecurityReports" }, "list": { "id": "apigee.organizations.hostSecurityReports.list", "response": { "$ref": "GoogleCloudApigeeV1ListSecurityReportsResponse" }, "httpMethod": "GET", "description": "Return a list of Security Reports at host level.", "flatPath": "v1/organizations/{organizationsId}/hostSecurityReports", "parameters": { "dataset": { "description": "Filter response list by dataset. Example: `api`, `mint`", "type": "string", "location": "query" }, "parent": { "required": true, "description": "Required. The parent resource name. Must be of the form `organizations/{org}`.", "location": "path", "type": "string", "pattern": "^organizations/[^/]+$" }, "pageToken": { "description": "Token returned from the previous list response to fetch the next page.", "location": "query", "type": "string" }, "from": { "location": "query", "type": "string", "description": "Filter response list by returning security reports that created after this date time. Time must be in ISO date-time format like '2011-12-03T10:15:30Z'." }, "pageSize": { "description": "The maximum number of security report to return in the list response.", "type": "integer", "location": "query", "format": "int32" }, "submittedBy": { "description": "Filter response list by user who submitted queries.", "type": "string", "location": "query" }, "to": { "description": "Filter response list by returning security reports that created before this date time. Time must be in ISO date-time format like '2011-12-03T10:16:30Z'.", "type": "string", "location": "query" }, "envgroupHostname": { "type": "string", "location": "query", "description": "Required. Filter response list by hostname." }, "status": { "location": "query", "type": "string", "description": "Filter response list by security report status." } }, "path": "v1/{+parent}/hostSecurityReports", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } }, "environments": { "methods": { "getAddonsConfig": { "description": "Gets the add-ons config of an environment.", "parameterOrder": [ "name" ], "parameters": { "name": { "location": "path", "type": "string", "pattern": "^organizations/[^/]+/environments/[^/]+/addonsConfig$", "required": true, "description": "Required. Name of the add-ons config. Must be in the format of `/organizations/{org}/environments/{env}/addonsConfig`" } }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/addonsConfig", "response": { "$ref": "GoogleCloudApigeeV1AddonsConfig" }, "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.environments.getAddonsConfig", "httpMethod": "GET" }, "getSecurityActionsConfig": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "path": "v1/{+name}", "parameterOrder": [ "name" ], "description": "GetSecurityActionConfig returns the current SecurityActions configuration.", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityActionsConfig", "response": { "$ref": "GoogleCloudApigeeV1SecurityActionsConfig" }, "id": "apigee.organizations.environments.getSecurityActionsConfig", "parameters": { "name": { "description": "Required. The name of the SecurityActionsConfig to retrieve. This will always be: `organizations/{org}/environments/{env}/security_actions_config`", "pattern": "^organizations/[^/]+/environments/[^/]+/securityActionsConfig$", "required": true, "location": "path", "type": "string" } } }, "subscribe": { "path": "v1/{+parent}:subscribe", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}:subscribe", "parameters": { "parent": { "description": "Required. Name of the environment. Use the following structure in your request: `organizations/{org}/environments/{env}`", "type": "string", "location": "path", "required": true, "pattern": "^organizations/[^/]+/environments/[^/]+$" } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.environments.subscribe", "response": { "$ref": "GoogleCloudApigeeV1Subscription" }, "parameterOrder": [ "parent" ], "description": "Creates a subscription for the environment's Pub/Sub topic. The server will assign a random name for this subscription. The \"name\" and \"push_config\" must *not* be specified." }, "updateTraceConfig": { "path": "v1/{+name}", "httpMethod": "PATCH", "description": "Updates the trace configurations in an environment. Note that the repeated fields have replace semantics when included in the field mask and that they will be overwritten by the value of the fields in the request body.", "parameterOrder": [ "name" ], "parameters": { "updateMask": { "format": "google-fieldmask", "type": "string", "location": "query", "description": "List of fields to be updated." }, "name": { "pattern": "^organizations/[^/]+/environments/[^/]+/traceConfig$", "description": "Required. Name of the trace configuration. Use the following structure in your request: \"organizations/*/environments/*/traceConfig\".", "type": "string", "location": "path", "required": true } }, "response": { "$ref": "GoogleCloudApigeeV1TraceConfig" }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/traceConfig", "request": { "$ref": "GoogleCloudApigeeV1TraceConfig" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.environments.updateTraceConfig" }, "delete": { "path": "v1/{+name}", "httpMethod": "DELETE", "parameterOrder": [ "name" ], "description": "Deletes an environment from an organization. **Warning: You must delete all key value maps and key value entries before you delete an environment.** Otherwise, if you re-create the environment the key value map entry operations will encounter encryption/decryption discrepancies.", "id": "apigee.organizations.environments.delete", "parameters": { "name": { "pattern": "^organizations/[^/]+/environments/[^/]+$", "description": "Required. Name of the environment. Use the following structure in your request: `organizations/{org}/environments/{env}`", "required": true, "type": "string", "location": "path" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}" }, "testIamPermissions": { "response": { "$ref": "GoogleIamV1TestIamPermissionsResponse" }, "parameterOrder": [ "resource" ], "path": "v1/{+resource}:testIamPermissions", "description": "Tests the permissions of a user on an environment, and returns a subset of permissions that the user has on the environment. If the environment does not exist, an empty permission set is returned (a NOT_FOUND error is not returned).", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}:testIamPermissions", "id": "apigee.organizations.environments.testIamPermissions", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "request": { "$ref": "GoogleIamV1TestIamPermissionsRequest" }, "parameters": { "resource": { "required": true, "type": "string", "pattern": "^organizations/[^/]+/environments/[^/]+$", "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path" } } }, "getIamPolicy": { "description": "Gets the IAM policy on an environment. For more information, see [Manage users, roles, and permissions using the API](https://cloud.google.com/apigee/docs/api-platform/system-administration/manage-users-roles). You must have the `apigee.environments.getIamPolicy` permission to call this API.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "options.requestedPolicyVersion": { "format": "int32", "type": "integer", "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "location": "query" }, "resource": { "required": true, "pattern": "^organizations/[^/]+/environments/[^/]+$", "type": "string", "location": "path", "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field." } }, "httpMethod": "GET", "response": { "$ref": "GoogleIamV1Policy" }, "parameterOrder": [ "resource" ], "id": "apigee.organizations.environments.getIamPolicy", "path": "v1/{+resource}:getIamPolicy", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}:getIamPolicy" }, "modifyEnvironment": { "description": "Updates properties for an Apigee environment with patch semantics using a field mask. **Note:** Not supported for Apigee hybrid.", "id": "apigee.organizations.environments.modifyEnvironment", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}", "parameters": { "name": { "description": "Required. Name of the environment. Use the following structure in your request: `organizations/{org}/environments/{environment}`.", "type": "string", "pattern": "^organizations/[^/]+/environments/[^/]+$", "required": true, "location": "path" }, "updateMask": { "type": "string", "format": "google-fieldmask", "description": "List of fields to be updated. Fields that can be updated: node_config.", "location": "query" } }, "parameterOrder": [ "name" ], "request": { "$ref": "GoogleCloudApigeeV1Environment" }, "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "PATCH", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}" }, "create": { "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "parent": { "pattern": "^organizations/[^/]+$", "description": "Required. Name of the organization in which the environment will be created. Use the following structure in your request: `organizations/{org}`", "required": true, "location": "path", "type": "string" }, "name": { "description": "Optional. Name of the environment.", "type": "string", "location": "query" } }, "description": "Creates an environment in an organization.", "parameterOrder": [ "parent" ], "request": { "$ref": "GoogleCloudApigeeV1Environment" }, "id": "apigee.organizations.environments.create", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+parent}/environments", "flatPath": "v1/organizations/{organizationsId}/environments", "httpMethod": "POST" }, "updateEnvironment": { "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}", "path": "v1/{+name}", "parameters": { "name": { "type": "string", "description": "Required. Name of the environment. Use the following structure in your request: `organizations/{org}/environments/{env}`", "pattern": "^organizations/[^/]+/environments/[^/]+$", "location": "path", "required": true } }, "httpMethod": "POST", "response": { "$ref": "GoogleCloudApigeeV1Environment" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.environments.updateEnvironment", "request": { "$ref": "GoogleCloudApigeeV1Environment" }, "description": "Updates an existing environment. When updating properties, you must pass all existing properties to the API, even if they are not being changed. If you omit properties from the payload, the properties are removed. To get the current list of properties for the environment, use the [Get Environment API](get). **Note**: Both `PUT` and `POST` methods are supported for updating an existing environment.", "parameterOrder": [ "name" ] }, "getTraceConfig": { "response": { "$ref": "GoogleCloudApigeeV1TraceConfig" }, "parameterOrder": [ "name" ], "description": "Get distributed trace configuration in an environment.", "id": "apigee.organizations.environments.getTraceConfig", "path": "v1/{+name}", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/traceConfig", "parameters": { "name": { "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+/traceConfig$", "required": true, "description": "Required. Name of the trace configuration. Use the following structure in your request: \"organizations/*/environments/*/traceConfig\".", "type": "string" } } }, "setIamPolicy": { "path": "v1/{+resource}:setIamPolicy", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Sets the IAM policy on an environment, if the policy already exists it will be replaced. For more information, see [Manage users, roles, and permissions using the API](https://cloud.google.com/apigee/docs/api-platform/system-administration/manage-users-roles). You must have the `apigee.environments.setIamPolicy` permission to call this API.", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}:setIamPolicy", "parameterOrder": [ "resource" ], "id": "apigee.organizations.environments.setIamPolicy", "response": { "$ref": "GoogleIamV1Policy" }, "request": { "$ref": "GoogleIamV1SetIamPolicyRequest" }, "parameters": { "resource": { "required": true, "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "pattern": "^organizations/[^/]+/environments/[^/]+$", "type": "string", "location": "path" } } }, "getDebugmask": { "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.environments.getDebugmask", "description": "Gets the debug mask singleton resource for an environment.", "path": "v1/{+name}", "response": { "$ref": "GoogleCloudApigeeV1DebugMask" }, "parameters": { "name": { "description": "Required. Name of the debug mask. Use the following structure in your request: `organizations/{org}/environments/{env}/debugmask`.", "location": "path", "required": true, "pattern": "^organizations/[^/]+/environments/[^/]+/debugmask$", "type": "string" } }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/debugmask", "parameterOrder": [ "name" ] }, "getDeployedConfig": { "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1EnvironmentConfig" }, "httpMethod": "GET", "description": "Gets the deployed configuration for an environment.", "parameterOrder": [ "name" ], "id": "apigee.organizations.environments.getDeployedConfig", "parameters": { "name": { "description": "Required. Name of the environment deployed configuration resource. Use the following structure in your request: `organizations/{org}/environments/{env}/deployedConfig`", "pattern": "^organizations/[^/]+/environments/[^/]+/deployedConfig$", "location": "path", "type": "string", "required": true } }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/deployedConfig" }, "get": { "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}", "path": "v1/{+name}", "httpMethod": "GET", "description": "Gets environment details.", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.environments.get", "parameters": { "name": { "pattern": "^organizations/[^/]+/environments/[^/]+$", "type": "string", "required": true, "location": "path", "description": "Required. Name of the environment. Use the following structure in your request: `organizations/{org}/environments/{env}`" } }, "response": { "$ref": "GoogleCloudApigeeV1Environment" } }, "update": { "httpMethod": "PUT", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1Environment" }, "request": { "$ref": "GoogleCloudApigeeV1Environment" }, "parameterOrder": [ "name" ], "id": "apigee.organizations.environments.update", "description": "Updates an existing environment. When updating properties, you must pass all existing properties to the API, even if they are not being changed. If you omit properties from the payload, the properties are removed. To get the current list of properties for the environment, use the [Get Environment API](get). **Note**: Both `PUT` and `POST` methods are supported for updating an existing environment.", "parameters": { "name": { "required": true, "pattern": "^organizations/[^/]+/environments/[^/]+$", "type": "string", "description": "Required. Name of the environment. Use the following structure in your request: `organizations/{org}/environments/{env}`", "location": "path" } }, "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}" }, "unsubscribe": { "parameterOrder": [ "parent" ], "httpMethod": "POST", "path": "v1/{+parent}:unsubscribe", "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "parent": { "location": "path", "description": "Required. Name of the environment. Use the following structure in your request: `organizations/{org}/environments/{env}`", "pattern": "^organizations/[^/]+/environments/[^/]+$", "type": "string", "required": true } }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}:unsubscribe", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.environments.unsubscribe", "description": "Deletes a subscription for the environment's Pub/Sub topic.", "request": { "$ref": "GoogleCloudApigeeV1Subscription" } }, "updateSecurityActionsConfig": { "description": "UpdateSecurityActionConfig updates the current SecurityActions configuration. This method is used to enable/disable the feature at the environment level.", "request": { "$ref": "GoogleCloudApigeeV1SecurityActionsConfig" }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityActionsConfig", "parameterOrder": [ "name" ], "parameters": { "updateMask": { "location": "query", "format": "google-fieldmask", "type": "string", "description": "The list of fields to update." }, "name": { "pattern": "^organizations/[^/]+/environments/[^/]+/securityActionsConfig$", "location": "path", "type": "string", "description": "This is a singleton resource, the name will always be set by SecurityActions and any user input will be ignored. The name is always: `organizations/{org}/environments/{env}/security_actions_config`", "required": true } }, "path": "v1/{+name}", "id": "apigee.organizations.environments.updateSecurityActionsConfig", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1SecurityActionsConfig" }, "httpMethod": "PATCH" }, "updateDebugmask": { "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/debugmask", "request": { "$ref": "GoogleCloudApigeeV1DebugMask" }, "path": "v1/{+name}", "parameters": { "replaceRepeatedFields": { "type": "boolean", "location": "query", "description": "Boolean flag that specifies whether to replace existing values in the debug mask when doing an update. Set to true to replace existing values. The default behavior is to append the values (false)." }, "updateMask": { "location": "query", "format": "google-fieldmask", "description": "Field debug mask to support partial updates.", "type": "string" }, "name": { "description": "Name of the debug mask.", "type": "string", "location": "path", "required": true, "pattern": "^organizations/[^/]+/environments/[^/]+/debugmask$" } }, "description": "Updates the debug mask singleton resource for an environment.", "response": { "$ref": "GoogleCloudApigeeV1DebugMask" }, "httpMethod": "PATCH", "id": "apigee.organizations.environments.updateDebugmask", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "getApiSecurityRuntimeConfig": { "id": "apigee.organizations.environments.getApiSecurityRuntimeConfig", "parameters": { "name": { "required": true, "description": "Required. Name of the environment API Security Runtime configuration resource. Use the following structure in your request: `organizations/{org}/environments/{env}/apiSecurityRuntimeConfig`", "pattern": "^organizations/[^/]+/environments/[^/]+/apiSecurityRuntimeConfig$", "type": "string", "location": "path" } }, "description": "Gets the API Security runtime configuration for an environment. This named ApiSecurityRuntimeConfig to prevent conflicts with ApiSecurityConfig from addon config.", "response": { "$ref": "GoogleCloudApigeeV1ApiSecurityRuntimeConfig" }, "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/apiSecurityRuntimeConfig" } }, "resources": { "apis": { "resources": { "deployments": { "methods": { "list": { "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/apis/{apisId}/deployments", "description": "Lists all deployments of an API proxy in an environment.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1ListDeploymentsResponse" }, "parameterOrder": [ "parent" ], "httpMethod": "GET", "id": "apigee.organizations.environments.apis.deployments.list", "path": "v1/{+parent}/deployments", "parameters": { "parent": { "type": "string", "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+/apis/[^/]+$", "description": "Required. Name representing an API proxy in an environment in the following format: `organizations/{org}/environments/{env}/apis/{api}`", "required": true } } } } }, "revisions": { "resources": { "debugsessions": { "methods": { "list": { "httpMethod": "GET", "description": "Lists debug sessions that are currently active in the given API Proxy revision.", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/debugsessions", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.environments.apis.revisions.debugsessions.list", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/apis/{apisId}/revisions/{revisionsId}/debugsessions", "parameters": { "pageSize": { "format": "int32", "location": "query", "description": "Maximum number of debug sessions to return. The page size defaults to 25.", "type": "integer" }, "pageToken": { "type": "string", "description": "Page token, returned from a previous ListDebugSessions call, that you can use to retrieve the next page.", "location": "query" }, "parent": { "required": true, "type": "string", "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+/apis/[^/]+/revisions/[^/]+$", "description": "Required. The name of the API Proxy revision deployment for which to list debug sessions. Must be of the form: `organizations/{organization}/environments/{environment}/apis/{api}/revisions/{revision}`." } }, "response": { "$ref": "GoogleCloudApigeeV1ListDebugSessionsResponse" } }, "create": { "path": "v1/{+parent}/debugsessions", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/apis/{apisId}/revisions/{revisionsId}/debugsessions", "response": { "$ref": "GoogleCloudApigeeV1DebugSession" }, "request": { "$ref": "GoogleCloudApigeeV1DebugSession" }, "httpMethod": "POST", "parameters": { "timeout": { "format": "int64", "description": "Optional. The time in seconds after which this DebugSession should end. A timeout specified in DebugSession will overwrite this value.", "location": "query", "type": "string" }, "parent": { "required": true, "pattern": "^organizations/[^/]+/environments/[^/]+/apis/[^/]+/revisions/[^/]+$", "type": "string", "description": "Required. The resource name of the API Proxy revision deployment for which to create the DebugSession. Must be of the form `organizations/{organization}/environments/{environment}/apis/{api}/revisions/{revision}`.", "location": "path" } }, "id": "apigee.organizations.environments.apis.revisions.debugsessions.create", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Creates a debug session for a deployed API Proxy revision.", "parameterOrder": [ "parent" ] }, "get": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "type": "string", "required": true, "pattern": "^organizations/[^/]+/environments/[^/]+/apis/[^/]+/revisions/[^/]+/debugsessions/[^/]+$", "description": "Required. The name of the debug session to retrieve. Must be of the form: `organizations/{organization}/environments/{environment}/apis/{api}/revisions/{revision}/debugsessions/{session}`." } }, "response": { "$ref": "GoogleCloudApigeeV1DebugSession" }, "description": "Retrieves a debug session.", "parameterOrder": [ "name" ], "id": "apigee.organizations.environments.apis.revisions.debugsessions.get", "path": "v1/{+name}", "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/apis/{apisId}/revisions/{revisionsId}/debugsessions/{debugsessionsId}" }, "deleteData": { "path": "v1/{+name}/data", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "required": true, "type": "string", "description": "Required. The name of the debug session to delete. Must be of the form: `organizations/{organization}/environments/{environment}/apis/{api}/revisions/{revision}/debugsessions/{debugsession}`.", "pattern": "^organizations/[^/]+/environments/[^/]+/apis/[^/]+/revisions/[^/]+/debugsessions/[^/]+$", "location": "path" } }, "httpMethod": "DELETE", "id": "apigee.organizations.environments.apis.revisions.debugsessions.deleteData", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes the data from a debug session. This does not cancel the debug session or prevent further data from being collected if the session is still active in runtime pods.", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/apis/{apisId}/revisions/{revisionsId}/debugsessions/{debugsessionsId}/data" } }, "resources": { "data": { "methods": { "get": { "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/apis/{apisId}/revisions/{revisionsId}/debugsessions/{debugsessionsId}/data/{dataId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "response": { "$ref": "GoogleCloudApigeeV1DebugSessionTransaction" }, "parameters": { "name": { "description": "Required. The name of the debug session transaction. Must be of the form: `organizations/{organization}/environments/{environment}/apis/{api}/revisions/{revision}/debugsessions/{session}/data/{transaction}`.", "required": true, "type": "string", "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+/apis/[^/]+/revisions/[^/]+/debugsessions/[^/]+/data/[^/]+$" } }, "id": "apigee.organizations.environments.apis.revisions.debugsessions.data.get", "httpMethod": "GET", "parameterOrder": [ "name" ], "description": "Gets the debug data from a transaction." } } } } }, "deployments": { "methods": { "generateUndeployChangeReport": { "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/apis/{apisId}/revisions/{revisionsId}/deployments:generateUndeployChangeReport", "httpMethod": "POST", "id": "apigee.organizations.environments.apis.revisions.deployments.generateUndeployChangeReport", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}/deployments:generateUndeployChangeReport", "parameters": { "name": { "required": true, "type": "string", "description": "Name of the API proxy revision deployment in the following format: `organizations/{org}/environments/{env}/apis/{api}/revisions/{rev}`", "pattern": "^organizations/[^/]+/environments/[^/]+/apis/[^/]+/revisions/[^/]+$", "location": "path" } }, "response": { "$ref": "GoogleCloudApigeeV1DeploymentChangeReport" }, "description": "Generates a report for a dry run analysis of an UndeployApiProxy request without committing the undeploy. In addition to the standard validations performed when removing deployments, additional analysis will be done to detect possible traffic routing changes that would result from this deployment being removed. Any potential routing conflicts or unsafe changes will be reported in the response. This routing analysis is not performed for a non-dry-run UndeployApiProxy request. For a request path `organizations/{org}/environments/{env}/apis/{api}/revisions/{rev}/deployments:generateUndeployChangeReport`, two permissions are required: * `apigee.deployments.delete` on the resource `organizations/{org}/environments/{env}` * `apigee.proxyrevisions.undeploy` on the resource `organizations/{org}/apis/{api}/revisions/{rev}`", "parameterOrder": [ "name" ] }, "generateDeployChangeReport": { "response": { "$ref": "GoogleCloudApigeeV1DeploymentChangeReport" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Generates a report for a dry run analysis of a DeployApiProxy request without committing the deployment. In addition to the standard validations performed when adding deployments, additional analysis will be done to detect possible traffic routing changes that would result from this deployment being created. Any potential routing conflicts or unsafe changes will be reported in the response. This routing analysis is not performed for a non-dry-run DeployApiProxy request. For a request path `organizations/{org}/environments/{env}/apis/{api}/revisions/{rev}/deployments:generateDeployChangeReport`, two permissions are required: * `apigee.deployments.create` on the resource `organizations/{org}/environments/{env}` * `apigee.proxyrevisions.deploy` on the resource `organizations/{org}/apis/{api}/revisions/{rev}`", "parameters": { "name": { "description": "Name of the API proxy revision deployment in the following format: `organizations/{org}/environments/{env}/apis/{api}/revisions/{rev}`", "type": "string", "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+/apis/[^/]+/revisions/[^/]+$", "required": true }, "override": { "description": "Flag that specifies whether to force the deployment of the new revision over the currently deployed revision by overriding conflict checks.", "location": "query", "type": "boolean" } }, "path": "v1/{+name}/deployments:generateDeployChangeReport", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/apis/{apisId}/revisions/{revisionsId}/deployments:generateDeployChangeReport", "parameterOrder": [ "name" ], "id": "apigee.organizations.environments.apis.revisions.deployments.generateDeployChangeReport", "httpMethod": "POST" } } } }, "methods": { "deploy": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/apis/{apisId}/revisions/{revisionsId}/deployments", "path": "v1/{+name}/deployments", "httpMethod": "POST", "response": { "$ref": "GoogleCloudApigeeV1Deployment" }, "id": "apigee.organizations.environments.apis.revisions.deploy", "parameters": { "serviceAccount": { "location": "query", "description": "Google Cloud IAM service account. The service account represents the identity of the deployed proxy, and determines what permissions it has. The format must be `{ACCOUNT_ID}@{PROJECT}.iam.gserviceaccount.com`.", "type": "string" }, "sequencedRollout": { "type": "boolean", "location": "query", "description": "Flag that specifies whether to enable sequenced rollout. If set to `true`, the routing rules for this deployment and the environment changes to add the deployment will be rolled out in a safe order. This reduces the risk of downtime that could be caused by changing the environment group's routing before the new destination for the affected traffic is ready to receive it. This should only be necessary if the new deployment will be capturing traffic from another environment under a shared environment group or if traffic will be rerouted to a different environment due to a base path removal. The generateDeployChangeReport API may be used to examine routing changes before issuing the deployment request, and its response will indicate if a sequenced rollout is recommended for the deployment." }, "override": { "location": "query", "description": "Flag that specifies whether the new deployment replaces other deployed revisions of the API proxy in the environment. Set `override` to `true` to replace other deployed revisions. By default, `override` is `false` and the deployment is rejected if other revisions of the API proxy are deployed in the environment.", "type": "boolean" }, "name": { "type": "string", "description": "Required. Name of the API proxy revision deployment in the following format: `organizations/{org}/environments/{env}/apis/{api}/revisions/{rev}`", "pattern": "^organizations/[^/]+/environments/[^/]+/apis/[^/]+/revisions/[^/]+$", "required": true, "location": "path" } }, "description": "Deploys a revision of an API proxy. If another revision of the same API proxy revision is currently deployed, set the `override` parameter to `true` to have this revision replace the currently deployed revision. You cannot invoke an API proxy until it has been deployed to an environment. After you deploy an API proxy revision, you cannot edit it. To edit the API proxy, you must create and deploy a new revision. For a request path `organizations/{org}/environments/{env}/apis/{api}/revisions/{rev}/deployments`, two permissions are required: * `apigee.deployments.create` on the resource `organizations/{org}/environments/{env}` * `apigee.proxyrevisions.deploy` on the resource `organizations/{org}/apis/{api}/revisions/{rev}` " }, "undeploy": { "httpMethod": "DELETE", "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "location": "path", "description": "Required. Name of the API proxy revision deployment in the following format: `organizations/{org}/environments/{env}/apis/{api}/revisions/{rev}`", "required": true, "type": "string", "pattern": "^organizations/[^/]+/environments/[^/]+/apis/[^/]+/revisions/[^/]+$" }, "sequencedRollout": { "description": "Flag that specifies whether to enable sequenced rollout. If set to `true`, the environment group routing rules corresponding to this deployment will be removed before removing the deployment from the runtime. This is likely to be a rare use case; it is only needed when the intended effect of undeploying this proxy is to cause the traffic it currently handles to be rerouted to some other existing proxy in the environment group. The GenerateUndeployChangeReport API may be used to examine routing changes before issuing the undeployment request, and its response will indicate if a sequenced rollout is recommended for the undeployment.", "type": "boolean", "location": "query" } }, "parameterOrder": [ "name" ], "id": "apigee.organizations.environments.apis.revisions.undeploy", "description": "Undeploys an API proxy revision from an environment. For a request path `organizations/{org}/environments/{env}/apis/{api}/revisions/{rev}/deployments`, two permissions are required: * `apigee.deployments.delete` on the resource `organizations/{org}/environments/{env}` * `apigee.proxyrevisions.undeploy` on the resource `organizations/{org}/apis/{api}/revisions/{rev}`", "path": "v1/{+name}/deployments", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/apis/{apisId}/revisions/{revisionsId}/deployments", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "getDeployments": { "response": { "$ref": "GoogleCloudApigeeV1Deployment" }, "httpMethod": "GET", "path": "v1/{+name}/deployments", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.environments.apis.revisions.getDeployments", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/apis/{apisId}/revisions/{revisionsId}/deployments", "description": "Gets the deployment of an API proxy revision and actual state reported by runtime pods.", "parameters": { "name": { "required": true, "pattern": "^organizations/[^/]+/environments/[^/]+/apis/[^/]+/revisions/[^/]+$", "location": "path", "type": "string", "description": "Required. Name representing an API proxy revision in an environment in the following format: `organizations/{org}/environments/{env}/apis/{api}/revisions/{rev}`" } }, "parameterOrder": [ "name" ] } } } } }, "securityActions": { "methods": { "get": { "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityActions/{securityActionsId}", "path": "v1/{+name}", "response": { "$ref": "GoogleCloudApigeeV1SecurityAction" }, "parameterOrder": [ "name" ], "description": "Get a SecurityAction by name.", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "required": true, "description": "Required. The fully qualified name of the SecurityAction to retrieve. Format: organizations/{org}/environments/{env}/securityActions/{security_action}", "location": "path", "type": "string", "pattern": "^organizations/[^/]+/environments/[^/]+/securityActions/[^/]+$" } }, "id": "apigee.organizations.environments.securityActions.get" }, "disable": { "parameterOrder": [ "name" ], "request": { "$ref": "GoogleCloudApigeeV1DisableSecurityActionRequest" }, "parameters": { "name": { "description": "Required. The name of the SecurityAction to disable. Format: organizations/{org}/environments/{env}/securityActions/{security_action}", "required": true, "location": "path", "type": "string", "pattern": "^organizations/[^/]+/environments/[^/]+/securityActions/[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}:disable", "httpMethod": "POST", "response": { "$ref": "GoogleCloudApigeeV1SecurityAction" }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityActions/{securityActionsId}:disable", "description": "Disable a SecurityAction. The `state` of the SecurityAction after disabling is `DISABLED`. `DisableSecurityAction` can be called on SecurityActions in the state `ENABLED`; SecurityActions in a different state (including `DISABLED`) return an error.", "id": "apigee.organizations.environments.securityActions.disable" }, "enable": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1SecurityAction" }, "description": "Enable a SecurityAction. The `state` of the SecurityAction after enabling is `ENABLED`. `EnableSecurityAction` can be called on SecurityActions in the state `DISABLED`; SecurityActions in a different state (including `ENABLED) return an error.", "httpMethod": "POST", "parameters": { "name": { "pattern": "^organizations/[^/]+/environments/[^/]+/securityActions/[^/]+$", "type": "string", "description": "Required. The name of the SecurityAction to enable. Format: organizations/{org}/environments/{env}/securityActions/{security_action}", "required": true, "location": "path" } }, "request": { "$ref": "GoogleCloudApigeeV1EnableSecurityActionRequest" }, "id": "apigee.organizations.environments.securityActions.enable", "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityActions/{securityActionsId}:enable", "path": "v1/{+name}:enable" }, "create": { "description": "CreateSecurityAction creates a SecurityAction.", "parameters": { "securityActionId": { "type": "string", "location": "query", "description": "Required. The ID to use for the SecurityAction, which will become the final component of the action's resource name. This value should be 0-61 characters, and valid format is (^[a-z]([a-z0-9-]{\u200b0,61}[a-z0-9])?$)." }, "parent": { "required": true, "type": "string", "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+$", "description": "Required. The organization and environment that this SecurityAction applies to. Format: organizations/{org}/environments/{env}" } }, "path": "v1/{+parent}/securityActions", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "id": "apigee.organizations.environments.securityActions.create", "response": { "$ref": "GoogleCloudApigeeV1SecurityAction" }, "request": { "$ref": "GoogleCloudApigeeV1SecurityAction" }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityActions", "parameterOrder": [ "parent" ] }, "list": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "parameters": { "pageSize": { "type": "integer", "format": "int32", "location": "query", "description": "The maximum number of SecurityActions to return. If unspecified, at most 50 SecurityActions will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000." }, "pageToken": { "type": "string", "location": "query", "description": "A page token, received from a previous `ListSecurityActions` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListSecurityActions` must match the call that provided the page token." }, "filter": { "description": "The filter expression to filter List results. https://google.aip.dev/160. Allows for filtering over: state and api_proxies. E.g.: state = ACTIVE AND apiProxies:foo. Filtering by action is not supported https://github.com/aip-dev/google.aip.dev/issues/624", "location": "query", "type": "string" }, "parent": { "type": "string", "pattern": "^organizations/[^/]+/environments/[^/]+$", "location": "path", "description": "Required. The parent, which owns this collection of SecurityActions. Format: organizations/{org}/environments/{env}", "required": true } }, "description": "Returns a list of SecurityActions. This returns both enabled and disabled actions.", "id": "apigee.organizations.environments.securityActions.list", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityActions", "path": "v1/{+parent}/securityActions", "response": { "$ref": "GoogleCloudApigeeV1ListSecurityActionsResponse" }, "httpMethod": "GET" } } }, "securityStats": { "methods": { "queryTabularStats": { "response": { "$ref": "GoogleCloudApigeeV1QueryTabularStatsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.environments.securityStats.queryTabularStats", "httpMethod": "POST", "description": "Retrieve security statistics as tabular rows.", "parameterOrder": [ "orgenv" ], "request": { "$ref": "GoogleCloudApigeeV1QueryTabularStatsRequest" }, "parameters": { "orgenv": { "description": "Required. Should be of the form organizations//environments/.", "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+$", "required": true, "type": "string" } }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityStats:queryTabularStats", "path": "v1/{+orgenv}/securityStats:queryTabularStats" }, "queryTimeSeriesStats": { "parameterOrder": [ "orgenv" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudApigeeV1QueryTimeSeriesStatsRequest" }, "response": { "$ref": "GoogleCloudApigeeV1QueryTimeSeriesStatsResponse" }, "httpMethod": "POST", "id": "apigee.organizations.environments.securityStats.queryTimeSeriesStats", "description": "Retrieve security statistics as a collection of time series.", "parameters": { "orgenv": { "description": "Required. Should be of the form organizations//environments/.", "type": "string", "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+$", "required": true } }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityStats:queryTimeSeriesStats", "path": "v1/{+orgenv}/securityStats:queryTimeSeriesStats" } } }, "sharedflows": { "resources": { "deployments": { "methods": { "list": { "description": "Lists all deployments of a shared flow in an environment.", "parameterOrder": [ "parent" ], "httpMethod": "GET", "parameters": { "parent": { "description": "Required. Name representing a shared flow in an environment in the following format: `organizations/{org}/environments/{env}/sharedflows/{sharedflow}`", "required": true, "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+/sharedflows/[^/]+$", "type": "string" } }, "id": "apigee.organizations.environments.sharedflows.deployments.list", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/sharedflows/{sharedflowsId}/deployments", "response": { "$ref": "GoogleCloudApigeeV1ListDeploymentsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+parent}/deployments" } } }, "revisions": { "methods": { "getDeployments": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets the deployment of a shared flow revision and actual state reported by runtime pods.", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/sharedflows/{sharedflowsId}/revisions/{revisionsId}/deployments", "response": { "$ref": "GoogleCloudApigeeV1Deployment" }, "httpMethod": "GET", "parameters": { "name": { "required": true, "description": "Required. Name representing a shared flow in an environment in the following format: `organizations/{org}/environments/{env}/sharedflows/{sharedflow}/revisions/{rev}`", "type": "string", "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+/sharedflows/[^/]+/revisions/[^/]+$" } }, "path": "v1/{+name}/deployments", "parameterOrder": [ "name" ], "id": "apigee.organizations.environments.sharedflows.revisions.getDeployments" }, "deploy": { "parameterOrder": [ "name" ], "path": "v1/{+name}/deployments", "response": { "$ref": "GoogleCloudApigeeV1Deployment" }, "httpMethod": "POST", "parameters": { "name": { "required": true, "description": "Required. Name of the shared flow revision to deploy in the following format: `organizations/{org}/environments/{env}/sharedflows/{sharedflow}/revisions/{rev}`", "pattern": "^organizations/[^/]+/environments/[^/]+/sharedflows/[^/]+/revisions/[^/]+$", "location": "path", "type": "string" }, "serviceAccount": { "location": "query", "type": "string", "description": "Google Cloud IAM service account. The service account represents the identity of the deployed proxy, and determines what permissions it has. The format must be `{ACCOUNT_ID}@{PROJECT}.iam.gserviceaccount.com`." }, "override": { "location": "query", "description": "Flag that specifies whether the new deployment replaces other deployed revisions of the shared flow in the environment. Set `override` to `true` to replace other deployed revisions. By default, `override` is `false` and the deployment is rejected if other revisions of the shared flow are deployed in the environment.", "type": "boolean" } }, "id": "apigee.organizations.environments.sharedflows.revisions.deploy", "description": "Deploys a revision of a shared flow. If another revision of the same shared flow is currently deployed, set the `override` parameter to `true` to have this revision replace the currently deployed revision. You cannot use a shared flow until it has been deployed to an environment. For a request path `organizations/{org}/environments/{env}/sharedflows/{sf}/revisions/{rev}/deployments`, two permissions are required: * `apigee.deployments.create` on the resource `organizations/{org}/environments/{env}` * `apigee.sharedflowrevisions.deploy` on the resource `organizations/{org}/sharedflows/{sf}/revisions/{rev}`", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/sharedflows/{sharedflowsId}/revisions/{revisionsId}/deployments", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "undeploy": { "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/sharedflows/{sharedflowsId}/revisions/{revisionsId}/deployments", "id": "apigee.organizations.environments.sharedflows.revisions.undeploy", "path": "v1/{+name}/deployments", "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "type": "string", "required": true, "description": "Required. Name of the shared flow revision to undeploy in the following format: `organizations/{org}/environments/{env}/sharedflows/{sharedflow}/revisions/{rev}`", "pattern": "^organizations/[^/]+/environments/[^/]+/sharedflows/[^/]+/revisions/[^/]+$" } }, "description": "Undeploys a shared flow revision from an environment. For a request path `organizations/{org}/environments/{env}/sharedflows/{sf}/revisions/{rev}/deployments`, two permissions are required: * `apigee.deployments.delete` on the resource `organizations/{org}/environments/{env}` * `apigee.sharedflowrevisions.undeploy` on the resource `organizations/{org}/sharedflows/{sf}/revisions/{rev}`" } } } } }, "addonsConfig": { "methods": { "setAddonEnablement": { "request": { "$ref": "GoogleCloudApigeeV1SetAddonEnablementRequest" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.environments.addonsConfig.setAddonEnablement", "parameterOrder": [ "name" ], "path": "v1/{+name}:setAddonEnablement", "description": "Updates an add-on enablement status of an environment.", "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "required": true, "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+/addonsConfig$", "type": "string", "description": "Required. Name of the add-ons config. Must be in the format of `/organizations/{org}/environments/{env}/addonsConfig`" } }, "httpMethod": "POST", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/addonsConfig:setAddonEnablement" } } }, "securityReports": { "methods": { "create": { "request": { "$ref": "GoogleCloudApigeeV1SecurityReportQuery" }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityReports", "path": "v1/{+parent}/securityReports", "parameters": { "parent": { "location": "path", "description": "Required. The parent resource name. Must be of the form `organizations/{org}/environments/{env}`.", "type": "string", "pattern": "^organizations/[^/]+/environments/[^/]+$", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1SecurityReport" }, "httpMethod": "POST", "id": "apigee.organizations.environments.securityReports.create", "parameterOrder": [ "parent" ], "description": "Submit a report request to be processed in the background. If the submission succeeds, the API returns a 200 status and an ID that refer to the report request. In addition to the HTTP status 200, the `state` of \"enqueued\" means that the request succeeded." }, "list": { "parameterOrder": [ "parent" ], "httpMethod": "GET", "path": "v1/{+parent}/securityReports", "response": { "$ref": "GoogleCloudApigeeV1ListSecurityReportsResponse" }, "parameters": { "status": { "type": "string", "description": "Filter response list by security reports status.", "location": "query" }, "parent": { "type": "string", "pattern": "^organizations/[^/]+/environments/[^/]+$", "description": "Required. The parent resource name. Must be of the form `organizations/{org}/environments/{env}`.", "required": true, "location": "path" }, "submittedBy": { "description": "Filter response list by user who submitted queries.", "location": "query", "type": "string" }, "pageToken": { "description": "Token returned from the previous list response to fetch the next page.", "type": "string", "location": "query" }, "to": { "location": "query", "type": "string", "description": "Filter response list by returning security reports that created before this date time. Time must be in ISO date-time format like '2011-12-03T10:16:30Z'." }, "dataset": { "location": "query", "type": "string", "description": "Filter response list by dataset. Example: `api`, `mint`" }, "pageSize": { "location": "query", "description": "The maximum number of security report to return in the list response.", "format": "int32", "type": "integer" }, "from": { "location": "query", "type": "string", "description": "Filter response list by returning security reports that created after this date time. Time must be in ISO date-time format like '2011-12-03T10:15:30Z'." } }, "description": "Return a list of Security Reports", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.environments.securityReports.list", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityReports" }, "getResultView": { "path": "v1/{+name}", "description": "After the query is completed, use this API to view the query result when result size is small.", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityReports/{securityReportsId}/resultView", "response": { "$ref": "GoogleCloudApigeeV1SecurityReportResultView" }, "parameterOrder": [ "name" ], "httpMethod": "GET", "id": "apigee.organizations.environments.securityReports.getResultView", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+/securityReports/[^/]+/resultView$", "type": "string", "required": true, "description": "Required. Name of the security report result view to get. Must be of the form `organizations/{org}/environments/{env}/securityReports/{reportId}/resultView`." } } }, "get": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "id": "apigee.organizations.environments.securityReports.get", "description": "Get security report status If the query is still in progress, the `state` is set to \"running\" After the query has completed successfully, `state` is set to \"completed\"", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityReports/{securityReportsId}", "parameterOrder": [ "name" ], "parameters": { "name": { "pattern": "^organizations/[^/]+/environments/[^/]+/securityReports/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. Name of the security report to get. Must be of the form `organizations/{org}/environments/{env}/securityReports/{reportId}`." } }, "path": "v1/{+name}", "response": { "$ref": "GoogleCloudApigeeV1SecurityReport" } }, "getResult": { "id": "apigee.organizations.environments.securityReports.getResult", "parameters": { "name": { "pattern": "^organizations/[^/]+/environments/[^/]+/securityReports/[^/]+/result$", "type": "string", "description": "Required. Name of the security report result to get. Must be of the form `organizations/{org}/environments/{env}/securityReports/{reportId}/result`.", "required": true, "location": "path" } }, "httpMethod": "GET", "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "After the query is completed, use this API to retrieve the results as file. If the request succeeds, and there is a non-zero result set, the result is downloaded to the client as a zipped JSON file. The name of the downloaded file will be: OfflineQueryResult-.zip Example: `OfflineQueryResult-9cfc0d85-0f30-46d6-ae6f-318d0cb961bd.zip`", "response": { "$ref": "GoogleApiHttpBody" }, "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityReports/{securityReportsId}/result" } } }, "caches": { "methods": { "delete": { "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Deletes a cache.", "parameterOrder": [ "name" ], "id": "apigee.organizations.environments.caches.delete", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/caches/{cachesId}", "path": "v1/{+name}", "parameters": { "name": { "pattern": "^organizations/[^/]+/environments/[^/]+/caches/[^/]+$", "required": true, "location": "path", "description": "Required. Cache resource name of the form: `organizations/{organization_id}/environments/{environment_id}/caches/{cache_id}`", "type": "string" } }, "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } }, "stats": { "methods": { "get": { "id": "apigee.organizations.environments.stats.get", "parameterOrder": [ "name" ], "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/stats/{statsId}", "description": "Retrieve metrics grouped by dimensions. The types of metrics you can retrieve include traffic, message counts, API call latency, response size, and cache hits and counts. Dimensions let you view metrics in meaningful groups. You can optionally pass dimensions as path parameters to the `stats` API. If dimensions are not specified, the metrics are computed on the entire set of data for the given time range.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1Stats" }, "parameters": { "realtime": { "description": "No longer used by Apigee. Supported for backwards compatibility.", "location": "query", "type": "boolean" }, "name": { "pattern": "^organizations/[^/]+/environments/[^/]+/stats/.*$", "description": "Required. Resource name for which the interactive query will be executed. Use the following format in your request: `organizations/{org}/environments/{env}/stats/{dimensions}` Dimensions let you view metrics in meaningful groupings, such as `apiproxy` or `target_host`. The value of dimensions should be a comma-separated list, as shown below: `organizations/{org}/environments/{env}/stats/apiproxy,request_verb`", "required": true, "type": "string", "location": "path" }, "topk": { "location": "query", "type": "string", "description": "Top number of results to return. For example, to return the top 5 results, set `topk=5`." }, "select": { "location": "query", "description": "Comma-separated list of metrics. For example: `sum(message_count),sum(error_count)`", "type": "string" }, "sortby": { "type": "string", "description": "Comma-separated list of columns to sort the final result.", "location": "query" }, "tzo": { "type": "string", "location": "query", "description": "Timezone offset value." }, "limit": { "description": "Maximum number of result items to return. The default and maximum value that can be returned is 14400.", "type": "string", "location": "query" }, "filter": { "description": "Filter that enables you to drill down on specific dimension values.", "type": "string", "location": "query" }, "sonar": { "description": "Routes the query to API Monitoring for the last hour.", "location": "query", "type": "boolean" }, "sort": { "type": "string", "description": "Flag that specifies whether the sort order should be ascending or descending. Valid values include: `DESC` and `ASC`.", "location": "query" }, "accuracy": { "location": "query", "type": "string", "description": "No longer used by Apigee. Supported for backwards compatibility." }, "timeUnit": { "description": "Granularity of metrics returned. Valid values include: `second`, `minute`, `hour`, `day`, `week`, or` month`.", "location": "query", "type": "string" }, "offset": { "location": "query", "type": "string", "description": "Offset value. Use `offset` with `limit` to enable pagination of results. For example, to display results 11-20, set limit to `10` and offset to `10`." }, "aggTable": { "location": "query", "type": "string", "description": "Table name used to query custom aggregate tables. If this parameter is skipped, then Apigee will try to retrieve the data from fact tables which will be expensive." }, "tsAscending": { "type": "boolean", "description": "Flag that specifies whether to list timestamps in ascending (`true`) or descending (`false`) order. Apigee recommends that you set this value to `true` if you are using `sortby` with `sort=DESC`.", "location": "query" }, "timeRange": { "description": "Time interval for the interactive query. Time range is specified in GMT as `start~end`. For example: `04/15/2017 00:00~05/15/2017 23:59`", "location": "query", "type": "string" } }, "httpMethod": "GET" } } }, "keyvaluemaps": { "methods": { "delete": { "parameters": { "name": { "required": true, "pattern": "^organizations/[^/]+/environments/[^/]+/keyvaluemaps/[^/]+$", "description": "Required. Name of the key value map. Use the following structure in your request: `organizations/{org}/environments/{env}/keyvaluemaps/{keyvaluemap}`", "location": "path", "type": "string" } }, "response": { "$ref": "GoogleCloudApigeeV1KeyValueMap" }, "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.environments.keyvaluemaps.delete", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keyvaluemaps/{keyvaluemapsId}", "parameterOrder": [ "name" ], "path": "v1/{+name}", "description": "Deletes a key value map from an environment." }, "create": { "parameterOrder": [ "parent" ], "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudApigeeV1KeyValueMap" }, "description": "Creates a key value map in an environment.", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keyvaluemaps", "path": "v1/{+parent}/keyvaluemaps", "response": { "$ref": "GoogleCloudApigeeV1KeyValueMap" }, "id": "apigee.organizations.environments.keyvaluemaps.create", "parameters": { "parent": { "required": true, "description": "Required. Name of the environment in which to create the key value map. Use the following structure in your request: `organizations/{org}/environments/{env}`", "type": "string", "pattern": "^organizations/[^/]+/environments/[^/]+$", "location": "path" } } } }, "resources": { "entries": { "methods": { "delete": { "parameterOrder": [ "name" ], "httpMethod": "DELETE", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}", "path": "v1/{+name}", "id": "apigee.organizations.environments.keyvaluemaps.entries.delete", "parameters": { "name": { "type": "string", "description": "Required. Scope as indicated by the URI in which to delete the key value map entry. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`.", "required": true, "pattern": "^organizations/[^/]+/environments/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$", "location": "path" } }, "description": "Deletes a key value entry from a key value map scoped to an organization, environment, or API proxy. **Notes:** * After you delete the key value entry, the policy consuming the entry will continue to function with its cached values for a few minutes. This is expected behavior. * Supported for Apigee hybrid 1.8.x and higher.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" } }, "list": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keyvaluemaps/{keyvaluemapsId}/entries", "path": "v1/{+parent}/entries", "description": "Lists key value entries for key values maps scoped to an organization, environment, or API proxy. **Note**: Supported for Apigee hybrid 1.8.x and higher.", "httpMethod": "GET", "parameters": { "pageToken": { "type": "string", "location": "query", "description": "Optional. Page token. If provides, must be a valid key value entry returned from a previous call that can be used to retrieve the next page." }, "parent": { "description": "Required. Scope as indicated by the URI in which to list key value maps. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", "type": "string", "pattern": "^organizations/[^/]+/environments/[^/]+/keyvaluemaps/[^/]+$", "required": true, "location": "path" }, "pageSize": { "format": "int32", "type": "integer", "description": "Optional. Maximum number of key value entries to return. If unspecified, at most 100 entries will be returned.", "location": "query" } }, "response": { "$ref": "GoogleCloudApigeeV1ListKeyValueEntriesResponse" }, "id": "apigee.organizations.environments.keyvaluemaps.entries.list", "parameterOrder": [ "parent" ] }, "create": { "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keyvaluemaps/{keyvaluemapsId}/entries", "httpMethod": "POST", "parameters": { "parent": { "pattern": "^organizations/[^/]+/environments/[^/]+/keyvaluemaps/[^/]+$", "location": "path", "type": "string", "description": "Required. Scope as indicated by the URI in which to create the key value map entry. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", "required": true } }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Creates key value entries in a key value map scoped to an organization, environment, or API proxy. **Note**: Supported for Apigee hybrid 1.8.x and higher.", "path": "v1/{+parent}/entries", "request": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "response": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "id": "apigee.organizations.environments.keyvaluemaps.entries.create" }, "get": { "id": "apigee.organizations.environments.keyvaluemaps.entries.get", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Get the key value entry value for a key value map scoped to an organization, environment, or API proxy. **Note**: Supported for Apigee hybrid 1.8.x and higher.", "parameterOrder": [ "name" ], "path": "v1/{+name}", "response": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "parameters": { "name": { "required": true, "location": "path", "type": "string", "pattern": "^organizations/[^/]+/environments/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$", "description": "Required. Scope as indicated by the URI in which to fetch the key value map entry/value. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`." } } }, "update": { "path": "v1/{+name}", "id": "apigee.organizations.environments.keyvaluemaps.entries.update", "parameters": { "name": { "required": true, "description": "Required. Scope as indicated by the URI in which to create the key value map entry. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", "pattern": "^organizations/[^/]+/environments/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$", "type": "string", "location": "path" } }, "request": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "description": "Update key value entry scoped to an organization, environment, or API proxy for an existing key.", "response": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "httpMethod": "PUT" } } } } }, "targetservers": { "methods": { "get": { "response": { "$ref": "GoogleCloudApigeeV1TargetServer" }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/targetservers/{targetserversId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets a TargetServer resource.", "parameters": { "name": { "description": "Required. The name of the TargetServer to get. Must be of the form `organizations/{org}/environments/{env}/targetservers/{target_server_id}`.", "type": "string", "pattern": "^organizations/[^/]+/environments/[^/]+/targetservers/[^/]+$", "required": true, "location": "path" } }, "path": "v1/{+name}", "id": "apigee.organizations.environments.targetservers.get", "httpMethod": "GET", "parameterOrder": [ "name" ] }, "delete": { "path": "v1/{+name}", "httpMethod": "DELETE", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/targetservers/{targetserversId}", "id": "apigee.organizations.environments.targetservers.delete", "description": "Deletes a TargetServer from an environment. Returns the deleted TargetServer resource.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "Required. The name of the TargetServer to delete. Must be of the form `organizations/{org}/environments/{env}/targetservers/{target_server_id}`.", "pattern": "^organizations/[^/]+/environments/[^/]+/targetservers/[^/]+$", "location": "path", "required": true, "type": "string" } }, "response": { "$ref": "GoogleCloudApigeeV1TargetServer" }, "parameterOrder": [ "name" ] }, "update": { "parameters": { "name": { "description": "Required. The name of the TargetServer to replace. Must be of the form `organizations/{org}/environments/{env}/targetservers/{target_server_id}`.", "location": "path", "type": "string", "required": true, "pattern": "^organizations/[^/]+/environments/[^/]+/targetservers/[^/]+$" } }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/targetservers/{targetserversId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1TargetServer" }, "id": "apigee.organizations.environments.targetservers.update", "httpMethod": "PUT", "description": "Updates an existing TargetServer. Note that this operation has PUT semantics; it will replace the entirety of the existing TargetServer with the resource in the request body.", "path": "v1/{+name}", "request": { "$ref": "GoogleCloudApigeeV1TargetServer" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "create": { "description": "Creates a TargetServer in the specified environment.", "request": { "$ref": "GoogleCloudApigeeV1TargetServer" }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/targetservers", "parameterOrder": [ "parent" ], "parameters": { "parent": { "pattern": "^organizations/[^/]+/environments/[^/]+$", "description": "Required. The parent environment name under which the TargetServer will be created. Must be of the form `organizations/{org}/environments/{env}`.", "type": "string", "required": true, "location": "path" }, "name": { "type": "string", "description": "Optional. The ID to give the TargetServer. This will overwrite the value in TargetServer.", "location": "query" } }, "httpMethod": "POST", "id": "apigee.organizations.environments.targetservers.create", "response": { "$ref": "GoogleCloudApigeeV1TargetServer" }, "path": "v1/{+parent}/targetservers", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } }, "optimizedStats": { "methods": { "get": { "description": "Similar to GetStats except that the response is less verbose.", "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/optimizedStats/{optimizedStatsId}", "httpMethod": "GET", "response": { "$ref": "GoogleCloudApigeeV1OptimizedStats" }, "id": "apigee.organizations.environments.optimizedStats.get", "parameters": { "timeRange": { "type": "string", "location": "query", "description": "Required. Time interval for the interactive query. Time range is specified in GMT as `start~end`. For example: `04/15/2017 00:00~05/15/2017 23:59`" }, "topk": { "type": "string", "location": "query", "description": "Top number of results to return. For example, to return the top 5 results, set `topk=5`." }, "timeUnit": { "description": "Granularity of metrics returned. Valid values include: `second`, `minute`, `hour`, `day`, `week`, or `month`.", "location": "query", "type": "string" }, "tsAscending": { "type": "boolean", "location": "query", "description": "Flag that specifies whether to list timestamps in ascending (`true`) or descending (`false`) order. Apigee recommends setting this value to `true` if you are using `sortby` with `sort=DESC`." }, "filter": { "type": "string", "location": "query", "description": "Filter that enables you to drill-down on specific dimension values." }, "select": { "type": "string", "location": "query", "description": "Required. Comma-separated list of metrics. For example: `sum(message_count),sum(error_count)`" }, "offset": { "description": "Offset value. Use `offset` with `limit` to enable pagination of results. For example, to display results 11-20, set limit to `10` and offset to `10`.", "type": "string", "location": "query" }, "realtime": { "description": "No longer used by Apigee. Supported for backwards compatibility.", "location": "query", "type": "boolean" }, "name": { "required": true, "pattern": "^organizations/[^/]+/environments/[^/]+/optimizedStats/.*$", "description": "Required. Resource name for which the interactive query will be executed. Use the following format in your request: `organizations/{org}/environments/{env}/optimizedStats/{dimensions}` Dimensions let you view metrics in meaningful groupings, such as `apiproxy`, `target_host`. The value of `dimensions` should be a comma-separated list as shown below: `organizations/{org}/environments/{env}/optimizedStats/apiproxy,request_verb`", "type": "string", "location": "path" }, "aggTable": { "type": "string", "location": "query", "description": "Table name used to query custom aggregate tables. If this parameter is skipped, then Apigee will try to retrieve the data from fact tables which will be expensive." }, "limit": { "type": "string", "description": "Maximum number of result items to return. The default and maximum value that can be returned is 14400.", "location": "query" }, "sonar": { "location": "query", "type": "boolean", "description": "Routes the query to API Monitoring for the last hour." }, "sortby": { "description": "Comma-separated list of columns to sort the final result.", "type": "string", "location": "query" }, "accuracy": { "type": "string", "location": "query", "description": "No longer used by Apigee. Supported for backwards compatibility." }, "sort": { "description": "Flag that specifies whether the sort order should be ascending or descending. Valid values include `DESC` and `ASC`.", "type": "string", "location": "query" }, "tzo": { "type": "string", "location": "query", "description": "Timezone offset value." } } } } }, "deployments": { "methods": { "list": { "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ListDeploymentsResponse" }, "description": "Lists all deployments of API proxies or shared flows in an environment.", "id": "apigee.organizations.environments.deployments.list", "path": "v1/{+parent}/deployments", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/deployments", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "parent": { "type": "string", "location": "path", "required": true, "pattern": "^organizations/[^/]+/environments/[^/]+$", "description": "Required. Name of the environment for which to return deployment information in the following format: `organizations/{org}/environments/{env}`" }, "sharedFlows": { "type": "boolean", "location": "query", "description": "Optional. Flag that specifies whether to return shared flow or API proxy deployments. Set to `true` to return shared flow deployments; set to `false` to return API proxy deployments. Defaults to `false`." } } } } }, "references": { "methods": { "delete": { "id": "apigee.organizations.environments.references.delete", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a Reference from an environment. Returns the deleted Reference resource.", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/references/{referencesId}", "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "DELETE", "response": { "$ref": "GoogleCloudApigeeV1Reference" }, "parameters": { "name": { "location": "path", "description": "Required. The name of the Reference to delete. Must be of the form `organizations/{org}/environments/{env}/references/{ref}`.", "pattern": "^organizations/[^/]+/environments/[^/]+/references/[^/]+$", "type": "string", "required": true } } }, "create": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1Reference" }, "parameterOrder": [ "parent" ], "id": "apigee.organizations.environments.references.create", "request": { "$ref": "GoogleCloudApigeeV1Reference" }, "description": "Creates a Reference in the specified environment.", "path": "v1/{+parent}/references", "parameters": { "parent": { "type": "string", "pattern": "^organizations/[^/]+/environments/[^/]+$", "required": true, "description": "Required. The parent environment name under which the Reference will be created. Must be of the form `organizations/{org}/environments/{env}`.", "location": "path" } }, "httpMethod": "POST", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/references" }, "update": { "response": { "$ref": "GoogleCloudApigeeV1Reference" }, "parameterOrder": [ "name" ], "description": "Updates an existing Reference. Note that this operation has PUT semantics; it will replace the entirety of the existing Reference with the resource in the request body.", "httpMethod": "PUT", "parameters": { "name": { "description": "Required. The name of the Reference to update. Must be of the form `organizations/{org}/environments/{env}/references/{ref}`.", "required": true, "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+/references/[^/]+$", "type": "string" } }, "id": "apigee.organizations.environments.references.update", "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/references/{referencesId}", "request": { "$ref": "GoogleCloudApigeeV1Reference" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets a Reference resource.", "id": "apigee.organizations.environments.references.get", "path": "v1/{+name}", "parameters": { "name": { "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+/references/[^/]+$", "type": "string", "description": "Required. The name of the Reference to get. Must be of the form `organizations/{org}/environments/{env}/references/{ref}`.", "required": true } }, "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/references/{referencesId}", "response": { "$ref": "GoogleCloudApigeeV1Reference" } } } }, "traceConfig": { "resources": { "overrides": { "methods": { "delete": { "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.environments.traceConfig.overrides.delete", "description": "Deletes a distributed trace configuration override.", "response": { "$ref": "GoogleProtobufEmpty" }, "httpMethod": "DELETE", "parameters": { "name": { "description": "Required. Name of the trace configuration override. Use the following structure in your request: \"organizations/*/environments/*/traceConfig/overrides/*\".", "required": true, "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+/traceConfig/overrides/[^/]+$", "type": "string" } }, "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/traceConfig/overrides/{overridesId}" }, "get": { "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/traceConfig/overrides/{overridesId}", "parameterOrder": [ "name" ], "id": "apigee.organizations.environments.traceConfig.overrides.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "type": "string", "required": true, "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+/traceConfig/overrides/[^/]+$", "description": "Required. Name of the trace configuration override. Use the following structure in your request: \"organizations/*/environments/*/traceConfig/overrides/*\"." } }, "response": { "$ref": "GoogleCloudApigeeV1TraceConfigOverride" }, "httpMethod": "GET", "description": "Gets a trace configuration override.", "path": "v1/{+name}" }, "create": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1TraceConfigOverride" }, "description": "Creates a trace configuration override. The response contains a system-generated UUID, that can be used to view, update, or delete the configuration override. Use the List API to view the existing trace configuration overrides.", "id": "apigee.organizations.environments.traceConfig.overrides.create", "httpMethod": "POST", "parameters": { "parent": { "pattern": "^organizations/[^/]+/environments/[^/]+/traceConfig$", "type": "string", "required": true, "description": "Required. Parent resource of the trace configuration override. Use the following structure in your request. \"organizations/*/environments/*/traceConfig\".", "location": "path" } }, "request": { "$ref": "GoogleCloudApigeeV1TraceConfigOverride" }, "path": "v1/{+parent}/overrides", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/traceConfig/overrides" }, "list": { "description": "Lists all of the distributed trace configuration overrides in an environment.", "id": "apigee.organizations.environments.traceConfig.overrides.list", "parameterOrder": [ "parent" ], "parameters": { "pageSize": { "description": "Maximum number of trace configuration overrides to return. If not specified, the maximum number returned is 25. The maximum number cannot exceed 100.", "type": "integer", "location": "query", "format": "int32" }, "pageToken": { "description": "A page token, returned from a previous `ListTraceConfigOverrides` call. Token value that can be used to retrieve the subsequent page. When paginating, all other parameters provided to `ListTraceConfigOverrides` must match those specified in the call to obtain the page token.", "location": "query", "type": "string" }, "parent": { "required": true, "description": "Required. Parent resource of the trace configuration override. Use the following structure in your request: \"organizations/*/environments/*/traceConfig\".", "type": "string", "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+/traceConfig$" } }, "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/traceConfig/overrides", "path": "v1/{+parent}/overrides", "response": { "$ref": "GoogleCloudApigeeV1ListTraceConfigOverridesResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "patch": { "parameterOrder": [ "name" ], "httpMethod": "PATCH", "id": "apigee.organizations.environments.traceConfig.overrides.patch", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudApigeeV1TraceConfigOverride" }, "parameters": { "name": { "pattern": "^organizations/[^/]+/environments/[^/]+/traceConfig/overrides/[^/]+$", "location": "path", "type": "string", "description": "Required. Name of the trace configuration override. Use the following structure in your request: \"organizations/*/environments/*/traceConfig/overrides/*\".", "required": true }, "updateMask": { "location": "query", "description": "List of fields to be updated.", "format": "google-fieldmask", "type": "string" } }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/traceConfig/overrides/{overridesId}", "response": { "$ref": "GoogleCloudApigeeV1TraceConfigOverride" }, "path": "v1/{+name}", "description": "Updates a distributed trace configuration override. Note that the repeated fields have replace semantics when included in the field mask and that they will be overwritten by the value of the fields in the request body." } } } } }, "flowhooks": { "methods": { "get": { "description": "Returns the name of the shared flow attached to the specified flow hook. If there's no shared flow attached to the flow hook, the API does not return an error; it simply does not return a name in the response.", "response": { "$ref": "GoogleCloudApigeeV1FlowHook" }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/flowhooks/{flowhooksId}", "id": "apigee.organizations.environments.flowhooks.get", "parameters": { "name": { "type": "string", "pattern": "^organizations/[^/]+/environments/[^/]+/flowhooks/[^/]+$", "required": true, "location": "path", "description": "Required. Name of the flow hook in the following format: `organizations/{org}/environments/{env}/flowhooks/{flowhook}`" } } }, "detachSharedFlowFromFlowHook": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/flowhooks/{flowhooksId}", "path": "v1/{+name}", "id": "apigee.organizations.environments.flowhooks.detachSharedFlowFromFlowHook", "description": "Detaches a shared flow from a flow hook.", "parameters": { "name": { "location": "path", "required": true, "pattern": "^organizations/[^/]+/environments/[^/]+/flowhooks/[^/]+$", "description": "Required. Name of the flow hook to detach in the following format: `organizations/{org}/environments/{env}/flowhooks/{flowhook}`", "type": "string" } }, "httpMethod": "DELETE", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1FlowHook" } }, "attachSharedFlowToFlowHook": { "id": "apigee.organizations.environments.flowhooks.attachSharedFlowToFlowHook", "parameters": { "name": { "required": true, "location": "path", "type": "string", "description": "Required. Name of the flow hook to which the shared flow should be attached in the following format: `organizations/{org}/environments/{env}/flowhooks/{flowhook}`", "pattern": "^organizations/[^/]+/environments/[^/]+/flowhooks/[^/]+$" } }, "description": "Attaches a shared flow to a flow hook.", "httpMethod": "PUT", "request": { "$ref": "GoogleCloudApigeeV1FlowHook" }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/flowhooks/{flowhooksId}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "response": { "$ref": "GoogleCloudApigeeV1FlowHook" } } } }, "keystores": { "resources": { "aliases": { "methods": { "delete": { "description": "Deletes an alias.", "parameters": { "name": { "pattern": "^organizations/[^/]+/environments/[^/]+/keystores/[^/]+/aliases/[^/]+$", "required": true, "description": "Required. Name of the alias. Use the following format in your request: `organizations/{org}/environments/{env}/keystores/{keystore}/aliases/{alias}`.", "type": "string", "location": "path" } }, "httpMethod": "DELETE", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keystores/{keystoresId}/aliases/{aliasesId}", "id": "apigee.organizations.environments.keystores.aliases.delete", "response": { "$ref": "GoogleCloudApigeeV1Alias" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "parameterOrder": [ "name" ] }, "getCertificate": { "description": "Gets the certificate from an alias in PEM-encoded form.", "path": "v1/{+name}/certificate", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "required": true, "description": "Required. Name of the alias. Use the following format in your request: `organizations/{org}/environments/{env}/keystores/{keystore}/aliases/{alias}`.", "location": "path", "type": "string", "pattern": "^organizations/[^/]+/environments/[^/]+/keystores/[^/]+/aliases/[^/]+$" } }, "response": { "$ref": "GoogleApiHttpBody" }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keystores/{keystoresId}/aliases/{aliasesId}/certificate", "id": "apigee.organizations.environments.keystores.aliases.getCertificate", "httpMethod": "GET", "parameterOrder": [ "name" ] }, "create": { "parameterOrder": [ "parent" ], "parameters": { "parent": { "description": "Required. Name of the keystore. Use the following format in your request: `organizations/{org}/environments/{env}/keystores/{keystore}`.", "location": "path", "required": true, "pattern": "^organizations/[^/]+/environments/[^/]+/keystores/[^/]+$", "type": "string" }, "_password": { "type": "string", "description": "DEPRECATED: For improved security, specify the password in the request body instead of using the query parameter. To specify the password in the request body, set `Content-type: multipart/form-data` part with name `password`. Password for the private key file, if required.", "location": "query" }, "ignoreExpiryValidation": { "description": "Flag that specifies whether to ignore expiry validation. If set to `true`, no expiry validation will be performed.", "location": "query", "type": "boolean" }, "ignoreNewlineValidation": { "location": "query", "type": "boolean", "description": "Flag that specifies whether to ignore newline validation. If set to `true`, no error is thrown when the file contains a certificate chain with no newline between each certificate. Defaults to `false`." }, "alias": { "description": "Alias for the key/certificate pair. Values must match the regular expression `[\\w\\s-.]{1,255}`. This must be provided for all formats except `selfsignedcert`; self-signed certs may specify the alias in either this parameter or the JSON body.", "location": "query", "type": "string" }, "format": { "location": "query", "description": "Required. Format of the data. Valid values include: `selfsignedcert`, `keycertfile`, or `pkcs12`", "type": "string" } }, "request": { "$ref": "GoogleApiHttpBody" }, "path": "v1/{+parent}/aliases", "httpMethod": "POST", "description": "Creates an alias from a key/certificate pair. The structure of the request is controlled by the `format` query parameter: - `keycertfile` - Separate PEM-encoded key and certificate files are uploaded. Set `Content-Type: multipart/form-data` and include the `keyFile`, `certFile`, and `password` (if keys are encrypted) fields in the request body. If uploading to a truststore, omit `keyFile`. - `pkcs12` - A PKCS12 file is uploaded. Set `Content-Type: multipart/form-data`, provide the file in the `file` field, and include the `password` field if the file is encrypted in the request body. - `selfsignedcert` - A new private key and certificate are generated. Set `Content-Type: application/json` and include CertificateGenerationSpec in the request body.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keystores/{keystoresId}/aliases", "id": "apigee.organizations.environments.keystores.aliases.create", "response": { "$ref": "GoogleCloudApigeeV1Alias" } }, "update": { "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keystores/{keystoresId}/aliases/{aliasesId}", "path": "v1/{+name}", "request": { "$ref": "GoogleApiHttpBody" }, "parameters": { "ignoreExpiryValidation": { "description": "Required. Flag that specifies whether to ignore expiry validation. If set to `true`, no expiry validation will be performed.", "type": "boolean", "location": "query" }, "name": { "pattern": "^organizations/[^/]+/environments/[^/]+/keystores/[^/]+/aliases/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. Name of the alias. Use the following format in your request: `organizations/{org}/environments/{env}/keystores/{keystore}/aliases/{alias}`" }, "ignoreNewlineValidation": { "description": "Flag that specifies whether to ignore newline validation. If set to `true`, no error is thrown when the file contains a certificate chain with no newline between each certificate. Defaults to `false`.", "type": "boolean", "location": "query" } }, "httpMethod": "PUT", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1Alias" }, "parameterOrder": [ "name" ], "description": "Updates the certificate in an alias.", "id": "apigee.organizations.environments.keystores.aliases.update" }, "csr": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Generates a PKCS #10 Certificate Signing Request for the private key in an alias.", "response": { "$ref": "GoogleApiHttpBody" }, "path": "v1/{+name}/csr", "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keystores/{keystoresId}/aliases/{aliasesId}/csr", "parameterOrder": [ "name" ], "parameters": { "name": { "required": true, "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+/keystores/[^/]+/aliases/[^/]+$", "type": "string", "description": "Required. Name of the alias. Use the following format in your request: `organizations/{org}/environments/{env}/keystores/{keystore}/aliases/{alias}`." } }, "id": "apigee.organizations.environments.keystores.aliases.csr" }, "get": { "response": { "$ref": "GoogleCloudApigeeV1Alias" }, "description": "Gets an alias.", "parameters": { "name": { "pattern": "^organizations/[^/]+/environments/[^/]+/keystores/[^/]+/aliases/[^/]+$", "type": "string", "required": true, "description": "Required. Name of the alias. Use the following format in your request: `organizations/{org}/environments/{env}/keystores/{keystore}/aliases/{alias}`.", "location": "path" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keystores/{keystoresId}/aliases/{aliasesId}", "parameterOrder": [ "name" ], "id": "apigee.organizations.environments.keystores.aliases.get", "path": "v1/{+name}", "httpMethod": "GET" } } } }, "methods": { "get": { "id": "apigee.organizations.environments.keystores.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets a keystore or truststore.", "parameters": { "name": { "required": true, "location": "path", "type": "string", "pattern": "^organizations/[^/]+/environments/[^/]+/keystores/[^/]+$", "description": "Required. Name of the keystore. Use the following format in your request: `organizations/{org}/environments/{env}/keystores/{keystore}`." } }, "response": { "$ref": "GoogleCloudApigeeV1Keystore" }, "path": "v1/{+name}", "httpMethod": "GET", "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keystores/{keystoresId}" }, "create": { "path": "v1/{+parent}/keystores", "parameterOrder": [ "parent" ], "parameters": { "parent": { "pattern": "^organizations/[^/]+/environments/[^/]+$", "type": "string", "location": "path", "description": "Required. Name of the environment in which to create the keystore. Use the following format in your request: `organizations/{org}/environments/{env}`", "required": true }, "name": { "location": "query", "description": "Optional. Name of the keystore. Overrides the value in Keystore.", "type": "string" } }, "response": { "$ref": "GoogleCloudApigeeV1Keystore" }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keystores", "httpMethod": "POST", "id": "apigee.organizations.environments.keystores.create", "request": { "$ref": "GoogleCloudApigeeV1Keystore" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Creates a keystore or truststore. - Keystore: Contains certificates and their associated keys. - Truststore: Contains trusted certificates used to validate a server's certificate. These certificates are typically self-signed certificates or certificates that are not signed by a trusted CA." }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1Keystore" }, "id": "apigee.organizations.environments.keystores.delete", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keystores/{keystoresId}", "parameters": { "name": { "description": "Required. Name of the keystore. Use the following format in your request: `organizations/{org}/environments/{env}/keystores/{keystore}`", "pattern": "^organizations/[^/]+/environments/[^/]+/keystores/[^/]+$", "required": true, "location": "path", "type": "string" } }, "path": "v1/{+name}", "httpMethod": "DELETE", "description": "Deletes a keystore or truststore.", "parameterOrder": [ "name" ] } } }, "queries": { "methods": { "create": { "parameters": { "parent": { "required": true, "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+$", "description": "Required. The parent resource name. Must be of the form `organizations/{org}/environments/{env}`.", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameterOrder": [ "parent" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/queries", "id": "apigee.organizations.environments.queries.create", "description": "Submit a query to be processed in the background. If the submission of the query succeeds, the API returns a 201 status and an ID that refer to the query. In addition to the HTTP status 201, the `state` of \"enqueued\" means that the request succeeded.", "path": "v1/{+parent}/queries", "request": { "$ref": "GoogleCloudApigeeV1Query" }, "response": { "$ref": "GoogleCloudApigeeV1AsyncQuery" } }, "get": { "parameters": { "name": { "required": true, "type": "string", "description": "Required. Name of the asynchronous query to get. Must be of the form `organizations/{org}/environments/{env}/queries/{queryId}`.", "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+/queries/[^/]+$" } }, "description": "Get query status If the query is still in progress, the `state` is set to \"running\" After the query has completed successfully, `state` is set to \"completed\"", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1AsyncQuery" }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/queries/{queriesId}", "path": "v1/{+name}", "httpMethod": "GET", "parameterOrder": [ "name" ], "id": "apigee.organizations.environments.queries.get" }, "list": { "description": "Return a list of Asynchronous Queries", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/queries", "id": "apigee.organizations.environments.queries.list", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "parameters": { "dataset": { "location": "query", "type": "string", "description": "Filter response list by dataset. Example: `api`, `mint`" }, "parent": { "description": "Required. The parent resource name. Must be of the form `organizations/{org}/environments/{env}`.", "location": "path", "type": "string", "pattern": "^organizations/[^/]+/environments/[^/]+$", "required": true }, "status": { "location": "query", "type": "string", "description": "Filter response list by asynchronous query status." }, "to": { "description": "Filter response list by returning asynchronous queries that created before this date time. Time must be in ISO date-time format like '2011-12-03T10:16:30Z'.", "location": "query", "type": "string" }, "submittedBy": { "description": "Filter response list by user who submitted queries.", "type": "string", "location": "query" }, "from": { "type": "string", "location": "query", "description": "Filter response list by returning asynchronous queries that created after this date time. Time must be in ISO date-time format like '2011-12-03T10:15:30Z'." }, "inclQueriesWithoutReport": { "type": "string", "description": "Flag to include asynchronous queries that don't have a report denifition.", "location": "query" } }, "response": { "$ref": "GoogleCloudApigeeV1ListAsyncQueriesResponse" }, "httpMethod": "GET", "path": "v1/{+parent}/queries" }, "getResult": { "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleApiHttpBody" }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/queries/{queriesId}/result", "description": "After the query is completed, use this API to retrieve the results. If the request succeeds, and there is a non-zero result set, the result is downloaded to the client as a zipped JSON file. The name of the downloaded file will be: OfflineQueryResult-.zip Example: `OfflineQueryResult-9cfc0d85-0f30-46d6-ae6f-318d0cb961bd.zip`", "parameters": { "name": { "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+/queries/[^/]+/result$", "description": "Required. Name of the asynchronous query result to get. Must be of the form `organizations/{org}/environments/{env}/queries/{queryId}/result`.", "type": "string", "required": true } }, "id": "apigee.organizations.environments.queries.getResult", "path": "v1/{+name}", "parameterOrder": [ "name" ] }, "getResulturl": { "parameters": { "name": { "pattern": "^organizations/[^/]+/environments/[^/]+/queries/[^/]+/resulturl$", "type": "string", "description": "Required. Name of the asynchronous query result to get. Must be of the form `organizations/{org}/environments/{env}/queries/{queryId}/resulturl`.", "required": true, "location": "path" } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1GetAsyncQueryResultUrlResponse" }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/queries/{queriesId}/resulturl", "path": "v1/{+name}", "description": "After the query is completed, use this API to retrieve the results. If the request succeeds, and there is a non-zero result set, the result is sent to the client as a list of urls to JSON files.", "id": "apigee.organizations.environments.queries.getResulturl" } } }, "resourcefiles": { "methods": { "listEnvironmentResources": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/resourcefiles/{type}", "parameterOrder": [ "parent", "type" ], "httpMethod": "GET", "path": "v1/{+parent}/resourcefiles/{type}", "description": "Lists all resource files, optionally filtering by type. For more information about resource files, see [Resource files](https://cloud.google.com/apigee/docs/api-platform/develop/resource-files).", "parameters": { "type": { "required": true, "location": "path", "description": "Optional. Type of resource files to list. {{ resource_file_type }}", "type": "string" }, "parent": { "location": "path", "type": "string", "required": true, "description": "Required. Name of the environment in which to list resource files in the following format: `organizations/{org}/environments/{env}`.", "pattern": "^organizations/[^/]+/environments/[^/]+$" } }, "id": "apigee.organizations.environments.resourcefiles.listEnvironmentResources", "response": { "$ref": "GoogleCloudApigeeV1ListEnvironmentResourcesResponse" } }, "delete": { "description": "Deletes a resource file. For more information about resource files, see [Resource files](https://cloud.google.com/apigee/docs/api-platform/develop/resource-files).", "parameters": { "parent": { "description": "Required. Name of the environment in the following format: `organizations/{org}/environments/{env}`.", "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+$", "required": true, "type": "string" }, "name": { "description": "Required. ID of the resource file to delete. Must match the regular expression: [a-zA-Z0-9:/\\\\!@#$%^&{}\\[\\]()+\\-=,.~'` ]{1,255}", "required": true, "type": "string", "location": "path" }, "type": { "type": "string", "required": true, "description": "Required. Resource file type. {{ resource_file_type }}", "location": "path" } }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/resourcefiles/{type}/{name}", "id": "apigee.organizations.environments.resourcefiles.delete", "httpMethod": "DELETE", "response": { "$ref": "GoogleCloudApigeeV1ResourceFile" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+parent}/resourcefiles/{type}/{name}", "parameterOrder": [ "parent", "type", "name" ] }, "get": { "path": "v1/{+parent}/resourcefiles/{type}/{name}", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/resourcefiles/{type}/{name}", "description": "Gets the contents of a resource file. For more information about resource files, see [Resource files](https://cloud.google.com/apigee/docs/api-platform/develop/resource-files).", "id": "apigee.organizations.environments.resourcefiles.get", "response": { "$ref": "GoogleApiHttpBody" }, "parameters": { "parent": { "pattern": "^organizations/[^/]+/environments/[^/]+$", "required": true, "location": "path", "description": "Required. Name of the environment in the following format: `organizations/{org}/environments/{env}`.", "type": "string" }, "type": { "location": "path", "required": true, "type": "string", "description": "Required. Resource file type. {{ resource_file_type }}" }, "name": { "type": "string", "location": "path", "description": "Required. ID of the resource file. Must match the regular expression: [a-zA-Z0-9:/\\\\!@#$%^&{}\\[\\]()+\\-=,.~'` ]{1,255}", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameterOrder": [ "parent", "type", "name" ] }, "create": { "parameterOrder": [ "parent" ], "id": "apigee.organizations.environments.resourcefiles.create", "path": "v1/{+parent}/resourcefiles", "httpMethod": "POST", "response": { "$ref": "GoogleCloudApigeeV1ResourceFile" }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/resourcefiles", "parameters": { "parent": { "required": true, "type": "string", "location": "path", "description": "Required. Name of the environment in which to create the resource file in the following format: `organizations/{org}/environments/{env}`.", "pattern": "^organizations/[^/]+/environments/[^/]+$" }, "name": { "type": "string", "description": "Required. Name of the resource file. Must match the regular expression: [a-zA-Z0-9:/\\\\!@#$%^&{}\\[\\]()+\\-=,.~'` ]{1,255}", "location": "query" }, "type": { "description": "Required. Resource file type. {{ resource_file_type }}", "location": "query", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Creates a resource file. Specify the `Content-Type` as `application/octet-stream` or `multipart/form-data`. For more information about resource files, see [Resource files](https://cloud.google.com/apigee/docs/api-platform/develop/resource-files).", "request": { "$ref": "GoogleApiHttpBody" } }, "update": { "response": { "$ref": "GoogleCloudApigeeV1ResourceFile" }, "parameterOrder": [ "parent", "type", "name" ], "path": "v1/{+parent}/resourcefiles/{type}/{name}", "description": "Updates a resource file. Specify the `Content-Type` as `application/octet-stream` or `multipart/form-data`. For more information about resource files, see [Resource files](https://cloud.google.com/apigee/docs/api-platform/develop/resource-files).", "parameters": { "type": { "description": "Required. Resource file type. {{ resource_file_type }}", "type": "string", "required": true, "location": "path" }, "name": { "required": true, "type": "string", "description": "Required. ID of the resource file to update. Must match the regular expression: [a-zA-Z0-9:/\\\\!@#$%^&{}\\[\\]()+\\-=,.~'` ]{1,255}", "location": "path" }, "parent": { "description": "Required. Name of the environment in the following format: `organizations/{org}/environments/{env}`.", "pattern": "^organizations/[^/]+/environments/[^/]+$", "required": true, "type": "string", "location": "path" } }, "request": { "$ref": "GoogleApiHttpBody" }, "id": "apigee.organizations.environments.resourcefiles.update", "httpMethod": "PUT", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/resourcefiles/{type}/{name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "path": "v1/{+parent}/resourcefiles", "id": "apigee.organizations.environments.resourcefiles.list", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1ListEnvironmentResourcesResponse" }, "description": "Lists all resource files, optionally filtering by type. For more information about resource files, see [Resource files](https://cloud.google.com/apigee/docs/api-platform/develop/resource-files).", "parameters": { "type": { "description": "Optional. Type of resource files to list. {{ resource_file_type }}", "location": "query", "type": "string" }, "parent": { "type": "string", "pattern": "^organizations/[^/]+/environments/[^/]+$", "location": "path", "description": "Required. Name of the environment in which to list resource files in the following format: `organizations/{org}/environments/{env}`.", "required": true } }, "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/resourcefiles" } } }, "analytics": { "resources": { "exports": { "methods": { "get": { "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/analytics/exports/{exportsId}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets the details and status of an analytics export job. If the export job is still in progress, its `state` is set to \"running\". After the export job has completed successfully, its `state` is set to \"completed\". If the export job fails, its `state` is set to `failed`.", "id": "apigee.organizations.environments.analytics.exports.get", "response": { "$ref": "GoogleCloudApigeeV1Export" }, "parameters": { "name": { "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+/analytics/exports/[^/]+$", "description": "Required. Resource name of the export to get.", "required": true, "type": "string" } }, "path": "v1/{+name}", "httpMethod": "GET" }, "create": { "request": { "$ref": "GoogleCloudApigeeV1ExportRequest" }, "response": { "$ref": "GoogleCloudApigeeV1Export" }, "httpMethod": "POST", "id": "apigee.organizations.environments.analytics.exports.create", "parameters": { "parent": { "location": "path", "type": "string", "description": "Required. Names of the parent organization and environment. Must be of the form `organizations/{org}/environments/{env}`.", "required": true, "pattern": "^organizations/[^/]+/environments/[^/]+$" } }, "description": "Submit a data export job to be processed in the background. If the request is successful, the API returns a 201 status, a URI that can be used to retrieve the status of the export job, and the `state` value of \"enqueued\".", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/analytics/exports", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/analytics/exports", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "parameterOrder": [ "parent" ], "description": "Lists the details and status of all analytics export jobs belonging to the parent organization and environment.", "id": "apigee.organizations.environments.analytics.exports.list", "httpMethod": "GET", "response": { "$ref": "GoogleCloudApigeeV1ListExportsResponse" }, "path": "v1/{+parent}/analytics/exports", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/analytics/exports", "parameters": { "parent": { "location": "path", "type": "string", "description": "Required. Names of the parent organization and environment. Must be of the form `organizations/{org}/environments/{env}`.", "pattern": "^organizations/[^/]+/environments/[^/]+$", "required": true } } } } }, "admin": { "methods": { "getSchemav2": { "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/analytics/admin/schemav2", "response": { "$ref": "GoogleCloudApigeeV1Schema" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "httpMethod": "GET", "parameterOrder": [ "name" ], "id": "apigee.organizations.environments.analytics.admin.getSchemav2", "description": "Gets a list of metrics and dimensions that can be used to create analytics queries and reports. Each schema element contains the name of the field, its associated type, and a flag indicating whether it is a standard or custom field.", "parameters": { "type": { "location": "query", "description": "Required. Name of the dataset for which you want to retrieve the schema. For example: `fact` or `agg_cus1`", "type": "string" }, "name": { "pattern": "^organizations/[^/]+/environments/[^/]+/analytics/admin/schemav2$", "type": "string", "location": "path", "description": "Required. Path to the schema. Use the following structure in your request: `organizations/{org}/environments/{env}/analytics/admin/schemav2`.", "required": true }, "disableCache": { "type": "boolean", "description": "Flag that specifies whether the schema is be read from the database or cache. Set to `true` to read the schema from the database. Defaults to cache.", "location": "query" } } } } } } }, "archiveDeployments": { "methods": { "delete": { "parameters": { "name": { "required": true, "type": "string", "pattern": "^organizations/[^/]+/environments/[^/]+/archiveDeployments/[^/]+$", "location": "path", "description": "Required. Name of the Archive Deployment in the following format: `organizations/{org}/environments/{env}/archiveDeployments/{id}`." } }, "httpMethod": "DELETE", "parameterOrder": [ "name" ], "description": "Deletes an archive deployment.", "id": "apigee.organizations.environments.archiveDeployments.delete", "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/archiveDeployments/{archiveDeploymentsId}", "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "id": "apigee.organizations.environments.archiveDeployments.get", "description": "Gets the specified ArchiveDeployment.", "response": { "$ref": "GoogleCloudApigeeV1ArchiveDeployment" }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/archiveDeployments/{archiveDeploymentsId}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "name": { "description": "Required. Name of the Archive Deployment in the following format: `organizations/{org}/environments/{env}/archiveDeployments/{id}`.", "required": true, "location": "path", "type": "string", "pattern": "^organizations/[^/]+/environments/[^/]+/archiveDeployments/[^/]+$" } }, "path": "v1/{+name}" }, "generateUploadUrl": { "request": { "$ref": "GoogleCloudApigeeV1GenerateUploadUrlRequest" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "location": "path", "required": true, "description": "Required. The organization and environment to upload to.", "pattern": "^organizations/[^/]+/environments/[^/]+$", "type": "string" } }, "response": { "$ref": "GoogleCloudApigeeV1GenerateUploadUrlResponse" }, "description": "Generates a signed URL for uploading an Archive zip file to Google Cloud Storage. Once the upload is complete, the signed URL should be passed to CreateArchiveDeployment. When uploading to the generated signed URL, please follow these restrictions: * Source file type should be a zip file. * Source file size should not exceed 1GB limit. * No credentials should be attached - the signed URLs provide access to the target bucket using internal service identity; if credentials were attached, the identity from the credentials would be used, but that identity does not have permissions to upload files to the URL. When making a HTTP PUT request, these two headers need to be specified: * `content-type: application/zip` * `x-goog-content-length-range: 0,1073741824` And this header SHOULD NOT be specified: * `Authorization: Bearer YOUR_TOKEN`", "id": "apigee.organizations.environments.archiveDeployments.generateUploadUrl", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/archiveDeployments:generateUploadUrl", "httpMethod": "POST", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/archiveDeployments:generateUploadUrl" }, "create": { "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/archiveDeployments", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Creates a new ArchiveDeployment.", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/archiveDeployments", "httpMethod": "POST", "response": { "$ref": "GoogleLongrunningOperation" }, "request": { "$ref": "GoogleCloudApigeeV1ArchiveDeployment" }, "parameters": { "parent": { "description": "Required. The Environment this Archive Deployment will be created in.", "required": true, "type": "string", "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+$" } }, "id": "apigee.organizations.environments.archiveDeployments.create" }, "list": { "response": { "$ref": "GoogleCloudApigeeV1ListArchiveDeploymentsResponse" }, "id": "apigee.organizations.environments.archiveDeployments.list", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/archiveDeployments", "description": "Lists the ArchiveDeployments in the specified Environment.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "parent": { "location": "path", "type": "string", "description": "Required. Name of the Environment for which to list Archive Deployments in the format: `organizations/{org}/environments/{env}`.", "required": true, "pattern": "^organizations/[^/]+/environments/[^/]+$" }, "filter": { "location": "query", "description": "Optional. An optional query used to return a subset of Archive Deployments using the semantics defined in https://google.aip.dev/160.", "type": "string" }, "pageSize": { "location": "query", "format": "int32", "description": "Optional. Maximum number of Archive Deployments to return. If unspecified, at most 25 deployments will be returned.", "type": "integer" }, "pageToken": { "description": "Optional. Page token, returned from a previous ListArchiveDeployments call, that you can use to retrieve the next page.", "type": "string", "location": "query" } }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/archiveDeployments" }, "generateDownloadUrl": { "response": { "$ref": "GoogleCloudApigeeV1GenerateDownloadUrlResponse" }, "description": "Generates a signed URL for downloading the original zip file used to create an Archive Deployment. The URL is only valid for a limited period and should be used within minutes after generation. Each call returns a new upload URL.", "httpMethod": "POST", "id": "apigee.organizations.environments.archiveDeployments.generateDownloadUrl", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudApigeeV1GenerateDownloadUrlRequest" }, "parameters": { "name": { "description": "Required. The name of the Archive Deployment you want to download.", "required": true, "type": "string", "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+/archiveDeployments/[^/]+$" } }, "path": "v1/{+name}:generateDownloadUrl", "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/archiveDeployments/{archiveDeploymentsId}:generateDownloadUrl" }, "patch": { "id": "apigee.organizations.environments.archiveDeployments.patch", "parameters": { "updateMask": { "location": "query", "format": "google-fieldmask", "type": "string", "description": "Required. The list of fields to be updated." }, "name": { "type": "string", "required": true, "pattern": "^organizations/[^/]+/environments/[^/]+/archiveDeployments/[^/]+$", "location": "path", "description": "Name of the Archive Deployment in the following format: `organizations/{org}/environments/{env}/archiveDeployments/{id}`." } }, "description": "Updates an existing ArchiveDeployment. Labels can modified but most of the other fields are not modifiable.", "path": "v1/{+name}", "request": { "$ref": "GoogleCloudApigeeV1ArchiveDeployment" }, "response": { "$ref": "GoogleCloudApigeeV1ArchiveDeployment" }, "parameterOrder": [ "name" ], "httpMethod": "PATCH", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/archiveDeployments/{archiveDeploymentsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } }, "securityIncidents": { "methods": { "get": { "id": "apigee.organizations.environments.securityIncidents.get", "parameters": { "name": { "type": "string", "pattern": "^organizations/[^/]+/environments/[^/]+/securityIncidents/[^/]+$", "required": true, "location": "path", "description": "Required. Security incident in the following format: `organizations/{org}/environments/{environment}/securityIncidents/{incident}'. Example: organizations/testOrg/environments/testEnv/securityIncidents/1234-4567-890-111" } }, "description": "GetSecurityIncident gets the specified security incident. Returns NOT_FOUND if security incident is not present for the specified organization and environment.", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}", "response": { "$ref": "GoogleCloudApigeeV1SecurityIncident" }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityIncidents/{securityIncidentsId}" }, "patch": { "request": { "$ref": "GoogleCloudApigeeV1SecurityIncident" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1SecurityIncident" }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityIncidents/{securityIncidentsId}", "id": "apigee.organizations.environments.securityIncidents.patch", "path": "v1/{+name}", "parameterOrder": [ "name" ], "httpMethod": "PATCH", "parameters": { "name": { "location": "path", "required": true, "description": "Immutable. Name of the security incident resource. Format: organizations/{org}/environments/{environment}/securityIncidents/{incident} Example: organizations/apigee-org/environments/dev/securityIncidents/1234-5678-9101-1111", "type": "string", "pattern": "^organizations/[^/]+/environments/[^/]+/securityIncidents/[^/]+$" }, "updateMask": { "format": "google-fieldmask", "location": "query", "description": "Required. The list of fields to update. Allowed fields are: LINT.IfChange(allowed_update_fields_comment) - observability LINT.ThenChange()", "type": "string" } }, "description": "UpdateSecurityIncidents updates an existing security incident." }, "list": { "description": "ListSecurityIncidents lists all the security incident associated with the environment.", "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityIncidents", "response": { "$ref": "GoogleCloudApigeeV1ListSecurityIncidentsResponse" }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+parent}/securityIncidents", "id": "apigee.organizations.environments.securityIncidents.list", "parameters": { "parent": { "required": true, "type": "string", "description": "Required. For a specific organization, list of all the security incidents. Format: `organizations/{org}/environments/{environment}`", "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+$" }, "pageSize": { "format": "int32", "description": "Optional. The maximum number of incidents to return. The service may return fewer than this value. If unspecified, at most 50 incidents will be returned.", "type": "integer", "location": "query" }, "filter": { "description": "The filter expression to be used to get the list of security incidents, where filtering can be done on API Proxies. Example: filter = \"api_proxy = /\", \"first_detected_time \u003e\", \"last_detected_time \u003c\"", "location": "query", "type": "string" }, "pageToken": { "type": "string", "description": "Optional. A page token, received from a previous `ListSecurityIncident` call. Provide this to retrieve the subsequent page.", "location": "query" } } }, "batchUpdate": { "parameters": { "parent": { "required": true, "location": "path", "pattern": "^organizations/[^/]+/environments/[^/]+$", "type": "string", "description": "Optional. The parent resource shared by all security incidents being updated. If this is set, the parent field in the UpdateSecurityIncidentRequest messages must either be empty or match this field." } }, "httpMethod": "POST", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityIncidents:batchUpdate", "request": { "$ref": "GoogleCloudApigeeV1BatchUpdateSecurityIncidentsRequest" }, "description": "BatchUpdateSecurityIncident updates multiple existing security incidents.", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/securityIncidents:batchUpdate", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.environments.securityIncidents.batchUpdate", "response": { "$ref": "GoogleCloudApigeeV1BatchUpdateSecurityIncidentsResponse" } } } } } }, "optimizedHostStats": { "methods": { "get": { "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "response": { "$ref": "GoogleCloudApigeeV1OptimizedStats" }, "id": "apigee.organizations.optimizedHostStats.get", "description": "Similar to GetHostStats except that the response is less verbose.", "flatPath": "v1/organizations/{organizationsId}/optimizedHostStats/{optimizedHostStatsId}", "parameterOrder": [ "name" ], "parameters": { "filter": { "location": "query", "type": "string", "description": "Filter that enables you to drill-down on specific dimension values." }, "tzo": { "location": "query", "type": "string", "description": "Timezone offset value." }, "topk": { "description": "Top number of results to return. For example, to return the top 5 results, set `topk=5`.", "type": "string", "location": "query" }, "offset": { "location": "query", "description": "Offset value. Use `offset` with `limit` to enable pagination of results. For example, to display results 11-20, set limit to `10` and offset to `10`.", "type": "string" }, "accuracy": { "location": "query", "type": "string", "description": "No longer used by Apigee. Supported for backwards compatibility." }, "timeRange": { "location": "query", "type": "string", "description": "Required. Time interval for the interactive query. Time range is specified in GMT as `start~end`. For example: `04/15/2017 00:00~05/15/2017 23:59`." }, "timeUnit": { "description": "Granularity of metrics returned. Valid values include: `second`, `minute`, `hour`, `day`, `week`, or `month`.", "location": "query", "type": "string" }, "select": { "type": "string", "description": "Required. Comma-separated list of metrics. For example: `sum(message_count),sum(error_count)`", "location": "query" }, "tsAscending": { "type": "boolean", "description": "Flag that specifies whether to list timestamps in ascending (`true`) or descending (`false`) order. Apigee recommends that you set this value to `true` if you are using `sortby` with `sort=DESC`.", "location": "query" }, "name": { "required": true, "location": "path", "pattern": "^organizations/[^/]+/optimizedHostStats/.*$", "description": "Required. Resource name for which the interactive query will be executed. Use the following format in your request: `organizations/{organization_id}/optimizedHostStats/{dimensions}` Dimensions let you view metrics in meaningful groupings, such as `apiproxy`, `target_host`. The value of dimensions should be a comma-separated list as shown below: `organizations/{org}/optimizedHostStats/apiproxy,request_verb`", "type": "string" }, "envgroupHostname": { "location": "query", "description": "Required. Hostname for which the interactive query will be executed.", "type": "string" }, "sortby": { "location": "query", "type": "string", "description": "Comma-separated list of columns used to sort the final result." }, "realtime": { "location": "query", "type": "boolean", "description": "No longer used by Apigee. Supported for backwards compatibility." }, "limit": { "type": "string", "description": "Maximum number of result items to return. The default and maximum value that can be returned is 14400.", "location": "query" }, "sort": { "description": "Flag that specifies whether the sort order should be ascending or descending. Valid values include `DESC` and `ASC`.", "location": "query", "type": "string" } } } } }, "hostQueries": { "methods": { "getResultView": { "flatPath": "v1/organizations/{organizationsId}/hostQueries/{hostQueriesId}/resultView", "response": { "$ref": "GoogleCloudApigeeV1AsyncQueryResultView" }, "path": "v1/{+name}", "parameterOrder": [ "name" ], "parameters": { "name": { "pattern": "^organizations/[^/]+/hostQueries/[^/]+/resultView$", "type": "string", "location": "path", "description": "Required. Name of the asynchronous query result view to get. Must be of the form `organizations/{org}/queries/{queryId}/resultView`.", "required": true } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "", "id": "apigee.organizations.hostQueries.getResultView" }, "create": { "parameterOrder": [ "parent" ], "request": { "$ref": "GoogleCloudApigeeV1Query" }, "path": "v1/{+parent}/hostQueries", "flatPath": "v1/organizations/{organizationsId}/hostQueries", "id": "apigee.organizations.hostQueries.create", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1AsyncQuery" }, "httpMethod": "POST", "parameters": { "parent": { "location": "path", "description": "Required. The parent resource name. Must be of the form `organizations/{org}`.", "type": "string", "required": true, "pattern": "^organizations/[^/]+$" } }, "description": "Submit a query at host level to be processed in the background. If the submission of the query succeeds, the API returns a 201 status and an ID that refer to the query. In addition to the HTTP status 201, the `state` of \"enqueued\" means that the request succeeded." }, "get": { "response": { "$ref": "GoogleCloudApigeeV1AsyncQuery" }, "path": "v1/{+name}", "parameters": { "name": { "type": "string", "location": "path", "description": "Required. Name of the asynchronous query to get. Must be of the form `organizations/{org}/queries/{queryId}`.", "pattern": "^organizations/[^/]+/hostQueries/[^/]+$", "required": true } }, "parameterOrder": [ "name" ], "httpMethod": "GET", "id": "apigee.organizations.hostQueries.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Get status of a query submitted at host level. If the query is still in progress, the `state` is set to \"running\" After the query has completed successfully, `state` is set to \"completed\"", "flatPath": "v1/organizations/{organizationsId}/hostQueries/{hostQueriesId}" }, "getResult": { "description": "After the query is completed, use this API to retrieve the results. If the request succeeds, and there is a non-zero result set, the result is downloaded to the client as a zipped JSON file. The name of the downloaded file will be: OfflineQueryResult-.zip Example: `OfflineQueryResult-9cfc0d85-0f30-46d6-ae6f-318d0cb961bd.zip`", "id": "apigee.organizations.hostQueries.getResult", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "Required. Name of the asynchronous query result to get. Must be of the form `organizations/{org}/queries/{queryId}/result`.", "location": "path", "type": "string", "pattern": "^organizations/[^/]+/hostQueries/[^/]+/result$", "required": true } }, "response": { "$ref": "GoogleApiHttpBody" }, "parameterOrder": [ "name" ], "httpMethod": "GET", "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/hostQueries/{hostQueriesId}/result" }, "list": { "flatPath": "v1/organizations/{organizationsId}/hostQueries", "response": { "$ref": "GoogleCloudApigeeV1ListAsyncQueriesResponse" }, "parameters": { "envgroupHostname": { "type": "string", "description": "Required. Filter response list by hostname.", "location": "query" }, "parent": { "description": "Required. The parent resource name. Must be of the form `organizations/{org}`.", "location": "path", "pattern": "^organizations/[^/]+$", "type": "string", "required": true }, "from": { "location": "query", "type": "string", "description": "Filter response list by returning asynchronous queries that created after this date time. Time must be in ISO date-time format like '2011-12-03T10:15:30Z'." }, "submittedBy": { "location": "query", "type": "string", "description": "Filter response list by user who submitted queries." }, "status": { "type": "string", "location": "query", "description": "Filter response list by asynchronous query status." }, "to": { "location": "query", "description": "Filter response list by returning asynchronous queries that created before this date time. Time must be in ISO date-time format like '2011-12-03T10:16:30Z'.", "type": "string" }, "inclQueriesWithoutReport": { "location": "query", "type": "string", "description": "Flag to include asynchronous queries that don't have a report denifition." }, "dataset": { "description": "Filter response list by dataset. Example: `api`, `mint`", "type": "string", "location": "query" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Return a list of Asynchronous Queries at host level.", "id": "apigee.organizations.hostQueries.list", "httpMethod": "GET", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/hostQueries" } } }, "apps": { "methods": { "list": { "response": { "$ref": "GoogleCloudApigeeV1ListAppsResponse" }, "flatPath": "v1/organizations/{organizationsId}/apps", "parameters": { "apiProduct": { "type": "string", "location": "query", "description": "API product." }, "keyStatus": { "location": "query", "description": "Optional. Key status of the app. Valid values include `approved` or `revoked`. Defaults to `approved`.", "type": "string" }, "pageSize": { "format": "int32", "type": "integer", "location": "query", "description": "Optional. Count of apps a single page can have in the response. If unspecified, at most 100 apps will be returned. The maximum value is 100; values above 100 will be coerced to 100. \"page_size\" is supported from ver 1.10.0 and above." }, "status": { "type": "string", "location": "query", "description": "Optional. Filter by the status of the app. Valid values are `approved` or `revoked`. Defaults to `approved`." }, "filter": { "location": "query", "type": "string", "description": "Optional. The filter expression to be used to get the list of apps, where filtering can be done on developerEmail, apiProduct, consumerKey, status, appId, appName, appType and appGroup. Examples: \"developerEmail=foo@bar.com\", \"appType=AppGroup\", or \"appType=Developer\" \"filter\" is supported from ver 1.10.0 and above." }, "parent": { "type": "string", "pattern": "^organizations/[^/]+$", "location": "path", "description": "Required. Resource path of the parent in the following format: `organizations/{org}`", "required": true }, "pageToken": { "location": "query", "description": "Optional. The starting index record for listing the developers. \"page_token\" is supported from ver 1.10.0 and above.", "type": "string" }, "includeCred": { "description": "Optional. Flag that specifies whether to include credentials in the response.", "type": "boolean", "location": "query" }, "rows": { "type": "string", "location": "query", "description": "Optional. Maximum number of app IDs to return. Defaults to 10000.", "format": "int64" }, "startKey": { "description": "Returns the list of apps starting from the specified app ID.", "type": "string", "location": "query" }, "ids": { "description": "Optional. Comma-separated list of app IDs on which to filter.", "type": "string", "location": "query" }, "apptype": { "type": "string", "description": "Optional. 'apptype' is no longer available. Use a 'filter' instead.", "location": "query" }, "expand": { "type": "boolean", "description": "Optional. Flag that specifies whether to return an expanded list of apps for the organization. Defaults to `false`.", "location": "query" } }, "description": "Lists IDs of apps within an organization that have the specified app status (approved or revoked) or are of the specified app type (developer or company).", "id": "apigee.organizations.apps.list", "path": "v1/{+parent}/apps", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET" }, "get": { "response": { "$ref": "GoogleCloudApigeeV1App" }, "description": "Gets the app profile for the specified app ID.", "flatPath": "v1/organizations/{organizationsId}/apps/{appsId}", "parameters": { "name": { "pattern": "^organizations/[^/]+/apps/[^/]+$", "required": true, "description": "Required. App ID in the following format: `organizations/{org}/apps/{app}`", "type": "string", "location": "path" } }, "httpMethod": "GET", "id": "apigee.organizations.apps.get", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}" } } }, "developers": { "methods": { "setDeveloperStatus": { "parameterOrder": [ "name" ], "description": "Sets the status of a developer. A developer is `active` by default. If you set a developer's status to `inactive`, the API keys assigned to the developer apps are no longer valid even though the API keys are set to `approved`. Inactive developers can still sign in to the developer portal and create apps; however, any new API keys generated during app creation won't work. To set the status of a developer, set the `action` query parameter to `active` or `inactive`, and the `Content-Type` header to `application/octet-stream`. If successful, the API call returns the following HTTP status code: `204 No Content`", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "parameters": { "name": { "description": "Required. Name of the developer. Use the following structure in your request: `organizations/{org}/developers/{developer_id}`", "location": "path", "pattern": "^organizations/[^/]+/developers/[^/]+$", "type": "string", "required": true }, "action": { "type": "string", "description": "Status of the developer. Valid values are `active` and `inactive`.", "location": "query" } }, "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}", "id": "apigee.organizations.developers.setDeveloperStatus", "response": { "$ref": "GoogleProtobufEmpty" }, "httpMethod": "POST" }, "getMonetizationConfig": { "httpMethod": "GET", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1DeveloperMonetizationConfig" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets the monetization configuration for the developer.", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/monetizationConfig", "path": "v1/{+name}", "parameters": { "name": { "pattern": "^organizations/[^/]+/developers/[^/]+/monetizationConfig$", "required": true, "type": "string", "location": "path", "description": "Required. Monetization configuration for the developer. Use the following structure in your request: `organizations/{org}/developers/{developer}/monetizationConfig`" } }, "id": "apigee.organizations.developers.getMonetizationConfig" }, "list": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.developers.list", "response": { "$ref": "GoogleCloudApigeeV1ListOfDevelopersResponse" }, "httpMethod": "GET", "path": "v1/{+parent}/developers", "description": "Lists all developers in an organization by email address. By default, the response does not include company developers. Set the `includeCompany` query parameter to `true` to include company developers. **Note**: A maximum of 1000 developers are returned in the response. You paginate the list of developers returned using the `startKey` and `count` query parameters.", "parameterOrder": [ "parent" ], "parameters": { "count": { "location": "query", "type": "string", "format": "int64", "description": "Optional. Number of developers to return in the API call. Use with the `startKey` parameter to provide more targeted filtering. The limit is 1000." }, "startKey": { "location": "query", "type": "string", "description": "**Note**: Must be used in conjunction with the `count` parameter. Email address of the developer from which to start displaying the list of developers. For example, if the an unfiltered list returns: ``` westley@example.com fezzik@example.com buttercup@example.com ``` and your `startKey` is `fezzik@example.com`, the list returned will be ``` fezzik@example.com buttercup@example.com ```" }, "expand": { "location": "query", "description": "Specifies whether to expand the results. Set to `true` to expand the results. This query parameter is not valid if you use the `count` or `startKey` query parameters.", "type": "boolean" }, "includeCompany": { "location": "query", "type": "boolean", "description": "Flag that specifies whether to include company details in the response." }, "parent": { "description": "Required. Name of the Apigee organization. Use the following structure in your request: `organizations/{org}`.", "required": true, "location": "path", "pattern": "^organizations/[^/]+$", "type": "string" }, "app": { "location": "query", "description": "Optional. List only Developers that are associated with the app. Note that start_key, count are not applicable for this filter criteria.", "type": "string" }, "ids": { "description": "Optional. List of IDs to include, separated by commas.", "location": "query", "type": "string" } }, "flatPath": "v1/organizations/{organizationsId}/developers" }, "update": { "description": "Updates a developer. This API replaces the existing developer details with those specified in the request. Include or exclude any existing details that you want to retain or delete, respectively. The custom attribute limit is 18. **Note**: OAuth access tokens and Key Management Service (KMS) entities (apps, developers, and API products) are cached for 180 seconds (current default). Any custom attributes associated with these entities are cached for at least 180 seconds after the entity is accessed at runtime. Therefore, an `ExpiresIn` element on the OAuthV2 policy won't be able to expire an access token in less than 180 seconds.", "path": "v1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1Developer" }, "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}", "parameters": { "name": { "description": "Required. Email address of the developer. Use the following structure in your request: `organizations/{org}/developers/{developer_email}`", "type": "string", "pattern": "^organizations/[^/]+/developers/[^/]+$", "location": "path", "required": true } }, "id": "apigee.organizations.developers.update", "request": { "$ref": "GoogleCloudApigeeV1Developer" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "PUT" }, "updateMonetizationConfig": { "httpMethod": "PUT", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "description": "Updates the monetization configuration for the developer.", "response": { "$ref": "GoogleCloudApigeeV1DeveloperMonetizationConfig" }, "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/monetizationConfig", "parameterOrder": [ "name" ], "id": "apigee.organizations.developers.updateMonetizationConfig", "parameters": { "name": { "description": "Required. Monetization configuration for the developer. Use the following structure in your request: `organizations/{org}/developers/{developer}/monetizationConfig`", "type": "string", "required": true, "location": "path", "pattern": "^organizations/[^/]+/developers/[^/]+/monetizationConfig$" } }, "request": { "$ref": "GoogleCloudApigeeV1DeveloperMonetizationConfig" } }, "create": { "request": { "$ref": "GoogleCloudApigeeV1Developer" }, "path": "v1/{+parent}/developers", "response": { "$ref": "GoogleCloudApigeeV1Developer" }, "id": "apigee.organizations.developers.create", "parameterOrder": [ "parent" ], "httpMethod": "POST", "description": "Creates a developer. Once created, the developer can register an app and obtain an API key. At creation time, a developer is set as `active`. To change the developer status, use the SetDeveloperStatus API.", "parameters": { "parent": { "type": "string", "required": true, "description": "Required. Name of the Apigee organization in which the developer is created. Use the following structure in your request: `organizations/{org}`.", "pattern": "^organizations/[^/]+$", "location": "path" } }, "flatPath": "v1/organizations/{organizationsId}/developers", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "httpMethod": "DELETE", "id": "apigee.organizations.developers.delete", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "parameters": { "name": { "type": "string", "location": "path", "pattern": "^organizations/[^/]+/developers/[^/]+$", "required": true, "description": "Required. Email address of the developer. Use the following structure in your request: `organizations/{org}/developers/{developer_email}`" } }, "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1Developer" }, "description": "Deletes a developer. All apps and API keys associated with the developer are also removed. **Warning**: This API will permanently delete the developer and related artifacts. To avoid permanently deleting developers and their artifacts, set the developer status to `inactive` using the SetDeveloperStatus API. **Note**: The delete operation is asynchronous. The developer app is deleted immediately, but its associated resources, such as apps and API keys, may take anywhere from a few seconds to a few minutes to be deleted.", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}" }, "get": { "parameterOrder": [ "name" ], "id": "apigee.organizations.developers.get", "response": { "$ref": "GoogleCloudApigeeV1Developer" }, "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}", "httpMethod": "GET", "description": "Returns the developer details, including the developer's name, email address, apps, and other information. **Note**: The response includes only the first 100 developer apps.", "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "Required. Email address of the developer. Use the following structure in your request: `organizations/{org}/developers/{developer_email}`", "required": true, "location": "path", "type": "string", "pattern": "^organizations/[^/]+/developers/[^/]+$" }, "action": { "location": "query", "type": "string", "description": "Status of the developer. Valid values are `active` or `inactive`." } } }, "attributes": { "httpMethod": "POST", "parameters": { "parent": { "description": "Required. Email address of the developer for which attributes are being updated. Use the following structure in your request: `organizations/{org}/developers/{developer_email}`", "type": "string", "location": "path", "required": true, "pattern": "^organizations/[^/]+/developers/[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.developers.attributes", "response": { "$ref": "GoogleCloudApigeeV1Attributes" }, "request": { "$ref": "GoogleCloudApigeeV1Attributes" }, "path": "v1/{+parent}/attributes", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/attributes", "parameterOrder": [ "parent" ], "description": "Updates developer attributes. This API replaces the existing attributes with those specified in the request. Add new attributes, and include or exclude any existing attributes that you want to retain or remove, respectively. The custom attribute limit is 18. **Note**: OAuth access tokens and Key Management Service (KMS) entities (apps, developers, and API products) are cached for 180 seconds (default). Any custom attributes associated with these entities are cached for at least 180 seconds after the entity is accessed at runtime. Therefore, an `ExpiresIn` element on the OAuthV2 policy won't be able to expire an access token in less than 180 seconds." }, "getBalance": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "path": "v1/{+name}", "parameters": { "name": { "description": "Required. Account balance for the developer. Use the following structure in your request: `organizations/{org}/developers/{developer}/balance`", "pattern": "^organizations/[^/]+/developers/[^/]+/balance$", "required": true, "location": "path", "type": "string" } }, "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/balance", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1DeveloperBalance" }, "description": "Gets the account balance for the developer.", "id": "apigee.organizations.developers.getBalance" } }, "resources": { "subscriptions": { "methods": { "create": { "httpMethod": "POST", "request": { "$ref": "GoogleCloudApigeeV1DeveloperSubscription" }, "parameterOrder": [ "parent" ], "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/subscriptions", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Creates a subscription to an API product. ", "path": "v1/{+parent}/subscriptions", "response": { "$ref": "GoogleCloudApigeeV1DeveloperSubscription" }, "parameters": { "parent": { "type": "string", "pattern": "^organizations/[^/]+/developers/[^/]+$", "required": true, "location": "path", "description": "Required. Email address of the developer that is purchasing a subscription to the API product. Use the following structure in your request: `organizations/{org}/developers/{developer_email}`" } }, "id": "apigee.organizations.developers.subscriptions.create" }, "get": { "path": "v1/{+name}", "description": "Gets details for an API product subscription.", "response": { "$ref": "GoogleCloudApigeeV1DeveloperSubscription" }, "parameterOrder": [ "name" ], "httpMethod": "GET", "id": "apigee.organizations.developers.subscriptions.get", "parameters": { "name": { "required": true, "pattern": "^organizations/[^/]+/developers/[^/]+/subscriptions/[^/]+$", "location": "path", "type": "string", "description": "Required. Name of the API product subscription. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/subscriptions/{subscription}`" } }, "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/subscriptions/{subscriptionsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+parent}/subscriptions", "response": { "$ref": "GoogleCloudApigeeV1ListDeveloperSubscriptionsResponse" }, "httpMethod": "GET", "description": "Lists all API product subscriptions for a developer.", "id": "apigee.organizations.developers.subscriptions.list", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/subscriptions", "parameterOrder": [ "parent" ], "parameters": { "startKey": { "description": "Name of the API product subscription from which to start displaying the list of subscriptions. If omitted, the list starts from the first item. For example, to view the API product subscriptions from 51-150, set the value of `startKey` to the name of the 51st subscription and set the value of `count` to 100.", "location": "query", "type": "string" }, "parent": { "location": "path", "description": "Required. Email address of the developer. Use the following structure in your request: `organizations/{org}/developers/{developer_email}`", "pattern": "^organizations/[^/]+/developers/[^/]+$", "required": true, "type": "string" }, "count": { "description": "Number of API product subscriptions to return in the API call. Use with `startKey` to provide more targeted filtering. Defaults to 100. The maximum limit is 1000.", "location": "query", "format": "int32", "type": "integer" } } }, "expire": { "id": "apigee.organizations.developers.subscriptions.expire", "httpMethod": "POST", "path": "v1/{+name}:expire", "response": { "$ref": "GoogleCloudApigeeV1DeveloperSubscription" }, "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/subscriptions/{subscriptionsId}:expire", "parameterOrder": [ "name" ], "parameters": { "name": { "location": "path", "pattern": "^organizations/[^/]+/developers/[^/]+/subscriptions/[^/]+$", "description": "Required. Name of the API product subscription. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/subscriptions/{subscription}`", "required": true, "type": "string" } }, "description": "Expires an API product subscription immediately.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudApigeeV1ExpireDeveloperSubscriptionRequest" } } } }, "apps": { "resources": { "attributes": { "methods": { "delete": { "parameters": { "name": { "required": true, "location": "path", "description": "Required. Name of the developer app attribute. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/apps/{app}/attributes/{attribute}`", "type": "string", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+/attributes/[^/]+$" } }, "response": { "$ref": "GoogleCloudApigeeV1Attribute" }, "id": "apigee.organizations.developers.apps.attributes.delete", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}/attributes/{attributesId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "description": "Deletes a developer app attribute.", "parameterOrder": [ "name" ], "httpMethod": "DELETE" }, "updateDeveloperAppAttribute": { "parameters": { "name": { "description": "Required. Name of the developer app attribute. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/apps/{app}/attributes/{attribute}`", "required": true, "location": "path", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+/attributes/[^/]+$", "type": "string" } }, "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}/attributes/{attributesId}", "httpMethod": "POST", "path": "v1/{+name}", "id": "apigee.organizations.developers.apps.attributes.updateDeveloperAppAttribute", "response": { "$ref": "GoogleCloudApigeeV1Attribute" }, "request": { "$ref": "GoogleCloudApigeeV1Attribute" }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Updates a developer app attribute. **Note**: OAuth access tokens and Key Management Service (KMS) entities (apps, developers, and API products) are cached for 180 seconds (current default). Any custom attributes associated with these entities are cached for at least 180 seconds after the entity is accessed at runtime. Therefore, an `ExpiresIn` element on the OAuthV2 policy won't be able to expire an access token in less than 180 seconds." }, "get": { "parameterOrder": [ "name" ], "id": "apigee.organizations.developers.apps.attributes.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1Attribute" }, "httpMethod": "GET", "path": "v1/{+name}", "parameters": { "name": { "description": "Required. Name of the developer app attribute. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/apps/{app}/attributes/{attribute}`", "type": "string", "location": "path", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+/attributes/[^/]+$", "required": true } }, "description": "Returns a developer app attribute.", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}/attributes/{attributesId}" }, "list": { "parameters": { "parent": { "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+$", "description": "Required. Name of the developer app. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/apps/{app}`", "required": true, "location": "path", "type": "string" } }, "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}/attributes", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "path": "v1/{+parent}/attributes", "response": { "$ref": "GoogleCloudApigeeV1Attributes" }, "description": "Returns a list of all developer app attributes.", "httpMethod": "GET", "id": "apigee.organizations.developers.apps.attributes.list" } } }, "keys": { "methods": { "replaceDeveloperAppKey": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1DeveloperAppKey" }, "id": "apigee.organizations.developers.apps.keys.replaceDeveloperAppKey", "parameters": { "name": { "description": "Name of the developer app key. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/apps/{app}/keys/{key}`", "location": "path", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+/keys/[^/]+$", "required": true, "type": "string" } }, "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}/keys/{keysId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "description": "Updates the scope of an app. This API replaces the existing scopes with those specified in the request. Include or exclude any existing scopes that you want to retain or delete, respectively. The specified scopes must already be defined for the API products associated with the app. This API sets the `scopes` element under the `apiProducts` element in the attributes of the app.", "httpMethod": "PUT", "request": { "$ref": "GoogleCloudApigeeV1DeveloperAppKey" } }, "get": { "description": "Gets details for a consumer key for a developer app, including the key and secret value, associated API products, and other information.", "path": "v1/{+name}", "parameters": { "name": { "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+/keys/[^/]+$", "type": "string", "description": "Name of the developer app key. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/apps/{app}/keys/{key}`", "required": true, "location": "path" } }, "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}/keys/{keysId}", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1DeveloperAppKey" }, "parameterOrder": [ "name" ], "id": "apigee.organizations.developers.apps.keys.get" }, "updateDeveloperAppKey": { "request": { "$ref": "GoogleCloudApigeeV1DeveloperAppKey" }, "parameters": { "action": { "location": "query", "type": "string", "description": "Approve or revoke the consumer key by setting this value to `approve` or `revoke`, respectively. The `Content-Type` header must be set to `application/octet-stream`." }, "name": { "description": "Name of the developer app key. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/apps/{app}/keys/{key}`", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+/keys/[^/]+$", "required": true, "location": "path", "type": "string" } }, "parameterOrder": [ "name" ], "httpMethod": "POST", "description": "Adds an API product to a developer app key, enabling the app that holds the key to access the API resources bundled in the API product. In addition, you can add attributes to a developer app key. This API replaces the existing attributes with those specified in the request. Include or exclude any existing attributes that you want to retain or delete, respectively. You can use the same key to access all API products associated with the app.", "id": "apigee.organizations.developers.apps.keys.updateDeveloperAppKey", "response": { "$ref": "GoogleCloudApigeeV1DeveloperAppKey" }, "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}/keys/{keysId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "create": { "id": "apigee.organizations.developers.apps.keys.create", "response": { "$ref": "GoogleCloudApigeeV1DeveloperAppKey" }, "request": { "$ref": "GoogleCloudApigeeV1DeveloperAppKey" }, "path": "v1/{+parent}/keys", "httpMethod": "POST", "description": "Creates a custom consumer key and secret for a developer app. This is particularly useful if you want to migrate existing consumer keys and secrets to Apigee from another system. Consumer keys and secrets can contain letters, numbers, underscores, and hyphens. No other special characters are allowed. To avoid service disruptions, a consumer key and secret should not exceed 2 KBs each. **Note**: When creating the consumer key and secret, an association to API products will not be made. Therefore, you should not specify the associated API products in your request. Instead, use the UpdateDeveloperAppKey API to make the association after the consumer key and secret are created. If a consumer key and secret already exist, you can keep them or delete them using the DeleteDeveloperAppKey API. **Note**: All keys start out with status=approved, even if status=revoked is passed when the key is created. To revoke a key, use the UpdateDeveloperAppKey API.", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}/keys", "parameters": { "parent": { "description": "Parent of the developer app key. Use the following structure in your request: 'organizations/{org}/developers/{developerEmail}/apps/{appName}'", "type": "string", "required": true, "location": "path", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+$" } } }, "delete": { "parameterOrder": [ "name" ], "path": "v1/{+name}", "response": { "$ref": "GoogleCloudApigeeV1DeveloperAppKey" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes an app's consumer key and removes all API products associated with the app. After the consumer key is deleted, it cannot be used to access any APIs. **Note**: After you delete a consumer key, you may want to: 1. Create a new consumer key and secret for the developer app using the CreateDeveloperAppKey API, and subsequently add an API product to the key using the UpdateDeveloperAppKey API. 2. Delete the developer app, if it is no longer required.", "id": "apigee.organizations.developers.apps.keys.delete", "parameters": { "name": { "required": true, "description": "Name of the developer app key. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/apps/{app}/keys/{key}`", "location": "path", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+/keys/[^/]+$", "type": "string" } }, "httpMethod": "DELETE", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}/keys/{keysId}" } }, "resources": { "apiproducts": { "methods": { "updateDeveloperAppKeyApiProduct": { "description": "Approves or revokes the consumer key for an API product. After a consumer key is approved, the app can use it to access APIs. A consumer key that is revoked or pending cannot be used to access an API. Any access tokens associated with a revoked consumer key will remain active. However, Apigee checks the status of the consumer key and if set to `revoked` will not allow access to the API.", "parameters": { "action": { "location": "query", "type": "string", "description": "Approve or revoke the consumer key by setting this value to `approve` or `revoke`, respectively." }, "name": { "type": "string", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+/keys/[^/]+/apiproducts/[^/]+$", "required": true, "description": "Name of the API product in the developer app key in the following format: `organizations/{org}/developers/{developer_email}/apps/{app}/keys/{key}/apiproducts/{apiproduct}`", "location": "path" } }, "id": "apigee.organizations.developers.apps.keys.apiproducts.updateDeveloperAppKeyApiProduct", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}/keys/{keysId}/apiproducts/{apiproductsId}" }, "delete": { "path": "v1/{+name}", "id": "apigee.organizations.developers.apps.keys.apiproducts.delete", "description": "Removes an API product from an app's consumer key. After the API product is removed, the app cannot access the API resources defined in that API product. **Note**: The consumer key is not removed, only its association with the API product.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1DeveloperAppKey" }, "parameters": { "name": { "location": "path", "required": true, "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+/keys/[^/]+/apiproducts/[^/]+$", "type": "string", "description": "Name of the API product in the developer app key in the following format: `organizations/{org}/developers/{developer_email}/apps/{app}/keys/{key}/apiproducts/{apiproduct}`" } }, "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}/keys/{keysId}/apiproducts/{apiproductsId}", "httpMethod": "DELETE" } } }, "create": { "methods": { "create": { "path": "v1/{+parent}/keys/create", "id": "apigee.organizations.developers.apps.keys.create.create", "description": "Creates a custom consumer key and secret for a developer app. This is particularly useful if you want to migrate existing consumer keys and secrets to Apigee from another system. Consumer keys and secrets can contain letters, numbers, underscores, and hyphens. No other special characters are allowed. To avoid service disruptions, a consumer key and secret should not exceed 2 KBs each. **Note**: When creating the consumer key and secret, an association to API products will not be made. Therefore, you should not specify the associated API products in your request. Instead, use the UpdateDeveloperAppKey API to make the association after the consumer key and secret are created. If a consumer key and secret already exist, you can keep them or delete them using the DeleteDeveloperAppKey API. **Note**: All keys start out with status=approved, even if status=revoked is passed when the key is created. To revoke a key, use the UpdateDeveloperAppKey API.", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}/keys/create", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "request": { "$ref": "GoogleCloudApigeeV1DeveloperAppKey" }, "response": { "$ref": "GoogleCloudApigeeV1DeveloperAppKey" }, "parameters": { "parent": { "location": "path", "type": "string", "required": true, "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+$", "description": "Parent of the developer app key. Use the following structure in your request: 'organizations/{org}/developers/{developerEmail}/apps/{appName}'" } } } } } } } }, "methods": { "delete": { "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}", "response": { "$ref": "GoogleCloudApigeeV1DeveloperApp" }, "description": "Deletes a developer app. **Note**: The delete operation is asynchronous. The developer app is deleted immediately, but its associated resources, such as app keys or access tokens, may take anywhere from a few seconds to a few minutes to be deleted.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "Required. Name of the developer app. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/apps/{app}`", "location": "path", "required": true, "type": "string", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+$" } }, "id": "apigee.organizations.developers.apps.delete", "path": "v1/{+name}", "parameterOrder": [ "name" ], "httpMethod": "DELETE" }, "create": { "response": { "$ref": "GoogleCloudApigeeV1DeveloperApp" }, "parameters": { "parent": { "description": "Required. Name of the developer. Use the following structure in your request: `organizations/{org}/developers/{developer_email}`", "pattern": "^organizations/[^/]+/developers/[^/]+$", "location": "path", "type": "string", "required": true } }, "httpMethod": "POST", "description": "Creates an app associated with a developer. This API associates the developer app with the specified API product and auto-generates an API key for the app to use in calls to API proxies inside that API product. The `name` is the unique ID of the app that you can use in API calls. The `DisplayName` (set as an attribute) appears in the UI. If you don't set the `DisplayName` attribute, the `name` appears in the UI.", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.developers.apps.create", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/apps", "request": { "$ref": "GoogleCloudApigeeV1DeveloperApp" } }, "attributes": { "request": { "$ref": "GoogleCloudApigeeV1Attributes" }, "response": { "$ref": "GoogleCloudApigeeV1Attributes" }, "id": "apigee.organizations.developers.apps.attributes", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}/attributes", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Updates attributes for a developer app. This API replaces the current attributes with those specified in the request.", "path": "v1/{+name}/attributes", "parameterOrder": [ "name" ], "parameters": { "name": { "description": "Required. Name of the developer app. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/apps/{app}`", "location": "path", "type": "string", "required": true, "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+$" } }, "httpMethod": "POST" }, "update": { "id": "apigee.organizations.developers.apps.update", "request": { "$ref": "GoogleCloudApigeeV1DeveloperApp" }, "response": { "$ref": "GoogleCloudApigeeV1DeveloperApp" }, "httpMethod": "PUT", "parameterOrder": [ "name" ], "parameters": { "name": { "location": "path", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+$", "type": "string", "required": true, "description": "Required. Name of the developer app. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/apps/{app}`" } }, "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}", "description": "Updates the details for a developer app. In addition, you can add an API product to a developer app and automatically generate an API key for the app to use when calling APIs in the API product. If you want to use an existing API key for the API product, add the API product to the API key using the UpdateDeveloperAppKey API. Using this API, you cannot update the following: * App name as it is the primary key used to identify the app and cannot be changed. * Scopes associated with the app. Instead, use the ReplaceDeveloperAppKey API. This API replaces the existing attributes with those specified in the request. Include or exclude any existing attributes that you want to retain or delete, respectively.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}" }, "generateKeyPairOrUpdateDeveloperAppStatus": { "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}", "httpMethod": "POST", "description": "Manages access to a developer app by enabling you to: * Approve or revoke a developer app * Generate a new consumer key and secret for a developer app To approve or revoke a developer app, set the `action` query parameter to `approve` or `revoke`, respectively, and the `Content-Type` header to `application/octet-stream`. If a developer app is revoked, none of its API keys are valid for API calls even though the keys are still approved. If successful, the API call returns the following HTTP status code: `204 No Content` To generate a new consumer key and secret for a developer app, pass the new key/secret details. Rather than replace an existing key, this API generates a new key. In this case, multiple key pairs may be associated with a single developer app. Each key pair has an independent status (`approve` or `revoke`) and expiration time. Any approved, non-expired key can be used in an API call. For example, if you're using API key rotation, you can generate new keys with expiration times that overlap keys that are going to expire. You might also generate a new consumer key/secret if the security of the original key/secret is compromised. The `keyExpiresIn` property defines the expiration time for the API key in milliseconds. If you don't set this property or set it to `-1`, the API key never expires. **Notes**: * When generating a new key/secret, this API replaces the existing attributes, notes, and callback URLs with those specified in the request. Include or exclude any existing information that you want to retain or delete, respectively. * To migrate existing consumer keys and secrets to hybrid from another system, see the CreateDeveloperAppKey API.", "response": { "$ref": "GoogleCloudApigeeV1DeveloperApp" }, "path": "v1/{+name}", "id": "apigee.organizations.developers.apps.generateKeyPairOrUpdateDeveloperAppStatus", "request": { "$ref": "GoogleCloudApigeeV1DeveloperApp" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "action": { "location": "query", "type": "string", "description": "Action. Valid values are `approve` or `revoke`." }, "name": { "description": "Required. Name of the developer app. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/apps/{app}`", "required": true, "type": "string", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+$", "location": "path" } } }, "list": { "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1ListDeveloperAppsResponse" }, "id": "apigee.organizations.developers.apps.list", "description": "Lists all apps created by a developer in an Apigee organization. Optionally, you can request an expanded view of the developer apps. A maximum of 100 developer apps are returned per API call. You can paginate the list of deveoper apps returned using the `startKey` and `count` query parameters.", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps", "httpMethod": "GET", "parameters": { "parent": { "description": "Required. Name of the developer. Use the following structure in your request: `organizations/{org}/developers/{developer_email}`", "location": "path", "required": true, "pattern": "^organizations/[^/]+/developers/[^/]+$", "type": "string" }, "count": { "location": "query", "description": "Number of developer apps to return in the API call. Use with the `startKey` parameter to provide more targeted filtering. The limit is 1000.", "type": "string", "format": "int64" }, "expand": { "type": "boolean", "description": "Optional. Specifies whether to expand the results. Set to `true` to expand the results. This query parameter is not valid if you use the `count` or `startKey` query parameters.", "location": "query" }, "startKey": { "type": "string", "location": "query", "description": "**Note**: Must be used in conjunction with the `count` parameter. Name of the developer app from which to start displaying the list of developer apps. For example, if you're returning 50 developer apps at a time (using the `count` query parameter), you can view developer apps 50-99 by entering the name of the 50th developer app. The developer app name is case sensitive." }, "shallowExpand": { "type": "boolean", "description": "Optional. Specifies whether to expand the results in shallow mode. Set to `true` to expand the results in shallow mode.", "location": "query" } }, "path": "v1/{+parent}/apps" }, "get": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}", "parameters": { "name": { "required": true, "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+$", "location": "path", "description": "Required. Name of the developer app. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/apps/{app}`", "type": "string" }, "query": { "type": "string", "location": "query", "description": "**Note**: Must be used in conjunction with the `entity` parameter. Set to `count` to return the number of API resources that have been approved for access by a developer app in the specified Apigee organization." }, "entity": { "description": "**Note**: Must be used in conjunction with the `query` parameter. Set to `apiresources` to return the number of API resources that have been approved for access by a developer app in the specified Apigee organization.", "type": "string", "location": "query" } }, "httpMethod": "GET", "parameterOrder": [ "name" ], "description": "Returns the details for a developer app.", "path": "v1/{+name}", "id": "apigee.organizations.developers.apps.get", "response": { "$ref": "GoogleCloudApigeeV1DeveloperApp" } } } }, "balance": { "methods": { "credit": { "path": "v1/{+name}:credit", "id": "apigee.organizations.developers.balance.credit", "httpMethod": "POST", "parameters": { "name": { "description": "Required. Account balance for the developer. Use the following structure in your request: `organizations/{org}/developers/{developer}/balance`", "location": "path", "required": true, "type": "string", "pattern": "^organizations/[^/]+/developers/[^/]+/balance$" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "request": { "$ref": "GoogleCloudApigeeV1CreditDeveloperBalanceRequest" }, "response": { "$ref": "GoogleCloudApigeeV1DeveloperBalance" }, "description": "Credits the account balance for the developer.", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/balance:credit" }, "adjust": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1DeveloperBalance" }, "path": "v1/{+name}:adjust", "id": "apigee.organizations.developers.balance.adjust", "description": "Adjust the prepaid balance for the developer. This API will be used in scenarios where the developer has been under-charged or over-charged.", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/balance:adjust", "parameterOrder": [ "name" ], "httpMethod": "POST", "parameters": { "name": { "required": true, "pattern": "^organizations/[^/]+/developers/[^/]+/balance$", "description": "Required. Account balance for the developer. Use the following structure in your request: `organizations/{org}/developers/{developer}/balance`", "type": "string", "location": "path" } }, "request": { "$ref": "GoogleCloudApigeeV1AdjustDeveloperBalanceRequest" } } } }, "attributes": { "methods": { "updateDeveloperAttribute": { "parameterOrder": [ "name" ], "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "pattern": "^organizations/[^/]+/developers/[^/]+/attributes/[^/]+$", "type": "string", "description": "Required. Name of the developer attribute. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/attributes/{attribute}`", "required": true, "location": "path" } }, "id": "apigee.organizations.developers.attributes.updateDeveloperAttribute", "description": "Updates a developer attribute. **Note**: OAuth access tokens and Key Management Service (KMS) entities (apps, developers, and API products) are cached for 180 seconds (default). Any custom attributes associated with these entities are cached for at least 180 seconds after the entity is accessed at runtime. Therefore, an `ExpiresIn` element on the OAuthV2 policy won't be able to expire an access token in less than 180 seconds.", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/attributes/{attributesId}", "path": "v1/{+name}", "response": { "$ref": "GoogleCloudApigeeV1Attribute" }, "request": { "$ref": "GoogleCloudApigeeV1Attribute" } }, "list": { "response": { "$ref": "GoogleCloudApigeeV1Attributes" }, "description": "Returns a list of all developer attributes.", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "parent": { "pattern": "^organizations/[^/]+/developers/[^/]+$", "type": "string", "required": true, "location": "path", "description": "Required. Email address of the developer for which attributes are being listed. Use the following structure in your request: `organizations/{org}/developers/{developer_email}`" } }, "path": "v1/{+parent}/attributes", "id": "apigee.organizations.developers.attributes.list", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/attributes" }, "get": { "description": "Returns the value of the specified developer attribute.", "parameters": { "name": { "description": "Required. Name of the developer attribute. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/attributes/{attribute}`", "pattern": "^organizations/[^/]+/developers/[^/]+/attributes/[^/]+$", "required": true, "type": "string", "location": "path" } }, "response": { "$ref": "GoogleCloudApigeeV1Attribute" }, "id": "apigee.organizations.developers.attributes.get", "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/attributes/{attributesId}" }, "delete": { "parameterOrder": [ "name" ], "httpMethod": "DELETE", "response": { "$ref": "GoogleCloudApigeeV1Attribute" }, "description": "Deletes a developer attribute.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "Required. Name of the developer attribute. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/attributes/{attribute}`", "type": "string", "required": true, "pattern": "^organizations/[^/]+/developers/[^/]+/attributes/[^/]+$", "location": "path" } }, "id": "apigee.organizations.developers.attributes.delete", "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/attributes/{attributesId}" } } } } }, "endpointAttachments": { "methods": { "get": { "id": "apigee.organizations.endpointAttachments.get", "response": { "$ref": "GoogleCloudApigeeV1EndpointAttachment" }, "description": "Gets the endpoint attachment.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/endpointAttachments/{endpointAttachmentsId}", "parameterOrder": [ "name" ], "path": "v1/{+name}", "parameters": { "name": { "required": true, "type": "string", "pattern": "^organizations/[^/]+/endpointAttachments/[^/]+$", "location": "path", "description": "Required. Name of the endpoint attachment. Use the following structure in your request: `organizations/{org}/endpointAttachments/{endpoint_attachment}`" } }, "httpMethod": "GET" }, "create": { "id": "apigee.organizations.endpointAttachments.create", "httpMethod": "POST", "parameterOrder": [ "parent" ], "flatPath": "v1/organizations/{organizationsId}/endpointAttachments", "request": { "$ref": "GoogleCloudApigeeV1EndpointAttachment" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+parent}/endpointAttachments", "parameters": { "parent": { "required": true, "location": "path", "pattern": "^organizations/[^/]+$", "type": "string", "description": "Required. Organization the endpoint attachment will be created in." }, "endpointAttachmentId": { "location": "query", "description": "ID to use for the endpoint attachment. ID must start with a lowercase letter followed by up to 31 lowercase letters, numbers, or hyphens, and cannot end with a hyphen. The minimum length is 2.", "type": "string" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Creates an endpoint attachment. **Note:** Not supported for Apigee hybrid." }, "list": { "flatPath": "v1/organizations/{organizationsId}/endpointAttachments", "path": "v1/{+parent}/endpointAttachments", "response": { "$ref": "GoogleCloudApigeeV1ListEndpointAttachmentsResponse" }, "parameterOrder": [ "parent" ], "id": "apigee.organizations.endpointAttachments.list", "description": "Lists the endpoint attachments in an organization.", "httpMethod": "GET", "parameters": { "pageSize": { "format": "int32", "location": "query", "description": "Optional. Maximum number of endpoint attachments to return. If unspecified, at most 25 attachments will be returned.", "type": "integer" }, "pageToken": { "type": "string", "location": "query", "description": "Optional. Page token, returned from a previous `ListEndpointAttachments` call, that you can use to retrieve the next page." }, "parent": { "description": "Required. Name of the organization for which to list endpoint attachments. Use the following structure in your request: `organizations/{org}`", "pattern": "^organizations/[^/]+$", "required": true, "location": "path", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1/organizations/{organizationsId}/endpointAttachments/{endpointAttachmentsId}", "parameterOrder": [ "name" ], "description": "Deletes an endpoint attachment.", "id": "apigee.organizations.endpointAttachments.delete", "httpMethod": "DELETE", "parameters": { "name": { "required": true, "pattern": "^organizations/[^/]+/endpointAttachments/[^/]+$", "type": "string", "location": "path", "description": "Required. Name of the endpoint attachment. Use the following structure in your request: `organizations/{org}/endpointAttachments/{endpoint_attachment}`" } }, "path": "v1/{+name}" } } }, "sites": { "resources": { "apicategories": { "methods": { "patch": { "parameters": { "name": { "description": "Required. Name of the category. Use the following structure in your request: `organizations/{org}/sites/{site}/apicategories/{apicategory}`", "location": "path", "pattern": "^organizations/[^/]+/sites/[^/]+/apicategories/[^/]+$", "type": "string", "required": true } }, "parameterOrder": [ "name" ], "httpMethod": "PATCH", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/sites/{sitesId}/apicategories/{apicategoriesId}", "description": "Updates an API category.", "response": { "$ref": "GoogleCloudApigeeV1ApiCategoryResponse" }, "request": { "$ref": "GoogleCloudApigeeV1ApiCategory" }, "path": "v1/{+name}", "id": "apigee.organizations.sites.apicategories.patch" }, "create": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1ApiCategoryResponse" }, "path": "v1/{+parent}/apicategories", "httpMethod": "POST", "parameters": { "parent": { "location": "path", "description": "Required. Name of the portal. Use the following structure in your request: `organizations/{org}/sites/{site}`", "required": true, "type": "string", "pattern": "^organizations/[^/]+/sites/[^/]+$" } }, "request": { "$ref": "GoogleCloudApigeeV1ApiCategory" }, "flatPath": "v1/organizations/{organizationsId}/sites/{sitesId}/apicategories", "parameterOrder": [ "parent" ], "description": "Creates a new API category.", "id": "apigee.organizations.sites.apicategories.create" }, "get": { "id": "apigee.organizations.sites.apicategories.get", "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/sites/{sitesId}/apicategories/{apicategoriesId}", "parameters": { "name": { "location": "path", "pattern": "^organizations/[^/]+/sites/[^/]+/apicategories/[^/]+$", "description": "Required. Name of the category. Use the following structure in your request: `organizations/{org}/sites/{site}/apicategories/{apicategory}`", "type": "string", "required": true } }, "httpMethod": "GET", "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets an API category.", "response": { "$ref": "GoogleCloudApigeeV1ApiCategoryResponse" } }, "list": { "path": "v1/{+parent}/apicategories", "response": { "$ref": "GoogleCloudApigeeV1ListApiCategoriesResponse" }, "parameters": { "parent": { "location": "path", "description": "Required. Name of the portal. Use the following structure in your request: `organizations/{org}/sites/{site}`", "required": true, "type": "string", "pattern": "^organizations/[^/]+/sites/[^/]+$" } }, "parameterOrder": [ "parent" ], "description": "Returns the API categories associated with a portal.", "id": "apigee.organizations.sites.apicategories.list", "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/sites/{sitesId}/apicategories", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "response": { "$ref": "GoogleCloudApigeeV1DeleteResponse" }, "id": "apigee.organizations.sites.apicategories.delete", "parameters": { "name": { "type": "string", "description": "Required. Name of the category. Use the following structure in your request: `organizations/{org}/sites/{site}/apicategories/{apicategory}`", "pattern": "^organizations/[^/]+/sites/[^/]+/apicategories/[^/]+$", "required": true, "location": "path" } }, "description": "Deletes an API category.", "flatPath": "v1/organizations/{organizationsId}/sites/{sitesId}/apicategories/{apicategoriesId}", "httpMethod": "DELETE", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}" } } }, "apidocs": { "methods": { "update": { "description": "Updates a catalog item.", "request": { "$ref": "GoogleCloudApigeeV1ApiDoc" }, "httpMethod": "PUT", "id": "apigee.organizations.sites.apidocs.update", "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/sites/{sitesId}/apidocs/{apidocsId}", "parameters": { "name": { "description": "Required. Name of the catalog item. Use the following structure in your request: `organizations/{org}/sites/{site}/apidocs/{apidoc}`", "type": "string", "location": "path", "required": true, "pattern": "^organizations/[^/]+/sites/[^/]+/apidocs/[^/]+$" } }, "response": { "$ref": "GoogleCloudApigeeV1ApiDocResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}" }, "updateDocumentation": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1ApiDocDocumentationResponse" }, "path": "v1/{+name}", "id": "apigee.organizations.sites.apidocs.updateDocumentation", "parameters": { "name": { "location": "path", "description": "Required. Resource name of the catalog item documentation. Use the following structure in your request: `organizations/{org}/sites/{site}/apidocs/{apidoc}/documentation`", "required": true, "type": "string", "pattern": "^organizations/[^/]+/sites/[^/]+/apidocs/[^/]+/documentation$" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "PATCH", "request": { "$ref": "GoogleCloudApigeeV1ApiDocDocumentation" }, "description": "Updates the documentation for the specified catalog item. Note that the documentation file contents will not be populated in the return message.", "flatPath": "v1/organizations/{organizationsId}/sites/{sitesId}/apidocs/{apidocsId}/documentation" }, "get": { "response": { "$ref": "GoogleCloudApigeeV1ApiDocResponse" }, "description": "Gets a catalog item.", "parameterOrder": [ "name" ], "parameters": { "name": { "description": "Required. Name of the catalog item. Use the following structure in your request: `organizations/{org}/sites/{site}/apidocs/{apidoc}`", "type": "string", "required": true, "location": "path", "pattern": "^organizations/[^/]+/sites/[^/]+/apidocs/[^/]+$" } }, "flatPath": "v1/organizations/{organizationsId}/sites/{sitesId}/apidocs/{apidocsId}", "id": "apigee.organizations.sites.apidocs.get", "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET" }, "create": { "response": { "$ref": "GoogleCloudApigeeV1ApiDocResponse" }, "flatPath": "v1/organizations/{organizationsId}/sites/{sitesId}/apidocs", "httpMethod": "POST", "path": "v1/{+parent}/apidocs", "parameters": { "parent": { "description": "Required. Name of the portal. Use the following structure in your request: `organizations/{org}/sites/{site}`", "pattern": "^organizations/[^/]+/sites/[^/]+$", "required": true, "type": "string", "location": "path" } }, "description": "Creates a new catalog item.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.sites.apidocs.create", "request": { "$ref": "GoogleCloudApigeeV1ApiDoc" }, "parameterOrder": [ "parent" ] }, "delete": { "flatPath": "v1/organizations/{organizationsId}/sites/{sitesId}/apidocs/{apidocsId}", "parameterOrder": [ "name" ], "id": "apigee.organizations.sites.apidocs.delete", "path": "v1/{+name}", "httpMethod": "DELETE", "description": "Deletes a catalog item.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1DeleteResponse" }, "parameters": { "name": { "pattern": "^organizations/[^/]+/sites/[^/]+/apidocs/[^/]+$", "type": "string", "description": "Required. Name of the catalog item. Use the following structure in your request: `organizations/{org}/sites/{site}/apidocs/{apidoc}`", "required": true, "location": "path" } } }, "list": { "response": { "$ref": "GoogleCloudApigeeV1ListApiDocsResponse" }, "parameterOrder": [ "parent" ], "parameters": { "pageToken": { "location": "query", "description": "Optional. A page token, received from a previous `ListApiDocs` call. Provide this to retrieve the subsequent page.", "type": "string" }, "parent": { "pattern": "^organizations/[^/]+/sites/[^/]+$", "required": true, "location": "path", "description": "Required. Name of the portal. Use the following structure in your request: `organizations/{org}/sites/{site}`", "type": "string" }, "pageSize": { "location": "query", "description": "Optional. The maximum number of items to return. The service may return fewer than this value. If unspecified, at most 25 books will be returned. The maximum value is 100; values above 100 will be coerced to 100.", "type": "integer", "format": "int32" } }, "path": "v1/{+parent}/apidocs", "flatPath": "v1/organizations/{organizationsId}/sites/{sitesId}/apidocs", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "id": "apigee.organizations.sites.apidocs.list", "description": "Returns the catalog items associated with a portal." }, "getDocumentation": { "parameters": { "name": { "description": "Required. Resource name of the catalog item documentation. Use the following structure in your request: `organizations/{org}/sites/{site}/apidocs/{apidoc}/documentation`", "required": true, "location": "path", "pattern": "^organizations/[^/]+/sites/[^/]+/apidocs/[^/]+/documentation$", "type": "string" } }, "path": "v1/{+name}", "description": "Gets the documentation for the specified catalog item.", "response": { "$ref": "GoogleCloudApigeeV1ApiDocDocumentationResponse" }, "parameterOrder": [ "name" ], "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/sites/{sitesId}/apidocs/{apidocsId}/documentation", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.sites.apidocs.getDocumentation" } } } } }, "securityAssessmentResults": { "methods": { "batchCompute": { "request": { "$ref": "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequest" }, "id": "apigee.organizations.securityAssessmentResults.batchCompute", "flatPath": "v1/organizations/{organizationsId}/securityAssessmentResults:batchCompute", "parameters": { "name": { "pattern": "^organizations/[^/]+/securityAssessmentResults$", "description": "Required. Name of the organization for which the score needs to be computed in the following format: `organizations/{org}/securityAssessmentResults`", "type": "string", "location": "path", "required": true } }, "description": "Compute RAV2 security scores for a set of resources.", "response": { "$ref": "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}:batchCompute", "parameterOrder": [ "name" ], "httpMethod": "POST" } } }, "reports": { "methods": { "delete": { "parameterOrder": [ "name" ], "path": "v1/{+name}", "parameters": { "name": { "required": true, "description": "Required. Custom Report name of the form: `organizations/{organization_id}/reports/{report_name}`", "type": "string", "pattern": "^organizations/[^/]+/reports/[^/]+$", "location": "path" } }, "id": "apigee.organizations.reports.delete", "response": { "$ref": "GoogleCloudApigeeV1DeleteCustomReportResponse" }, "flatPath": "v1/organizations/{organizationsId}/reports/{reportsId}", "httpMethod": "DELETE", "description": "Deletes an existing custom report definition", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "update": { "response": { "$ref": "GoogleCloudApigeeV1CustomReport" }, "flatPath": "v1/organizations/{organizationsId}/reports/{reportsId}", "request": { "$ref": "GoogleCloudApigeeV1CustomReport" }, "description": "Update an existing custom report definition", "httpMethod": "PUT", "id": "apigee.organizations.reports.update", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "Required. Custom Report name of the form: `organizations/{organization_id}/reports/{report_name}`", "required": true, "location": "path", "type": "string", "pattern": "^organizations/[^/]+/reports/[^/]+$" } }, "parameterOrder": [ "name" ], "path": "v1/{+name}" }, "create": { "response": { "$ref": "GoogleCloudApigeeV1CustomReport" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.reports.create", "path": "v1/{+parent}/reports", "parameterOrder": [ "parent" ], "flatPath": "v1/organizations/{organizationsId}/reports", "parameters": { "parent": { "type": "string", "required": true, "description": "Required. The parent organization name under which the Custom Report will be created. Must be of the form: `organizations/{organization_id}/reports`", "pattern": "^organizations/[^/]+$", "location": "path" } }, "description": "Creates a Custom Report for an Organization. A Custom Report provides Apigee Customers to create custom dashboards in addition to the standard dashboards which are provided. The Custom Report in its simplest form contains specifications about metrics, dimensions and filters. It is important to note that the custom report by itself does not provide an executable entity. The Edge UI converts the custom report definition into an analytics query and displays the result in a chart.", "httpMethod": "POST", "request": { "$ref": "GoogleCloudApigeeV1CustomReport" } }, "get": { "response": { "$ref": "GoogleCloudApigeeV1CustomReport" }, "description": "Retrieve a custom report definition.", "parameterOrder": [ "name" ], "id": "apigee.organizations.reports.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/reports/{reportsId}", "path": "v1/{+name}", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. Custom Report name of the form: `organizations/{organization_id}/reports/{report_name}`", "pattern": "^organizations/[^/]+/reports/[^/]+$" } } }, "list": { "parameters": { "parent": { "type": "string", "location": "path", "required": true, "description": "Required. The parent organization name under which the API product will be listed `organizations/{organization_id}/reports`", "pattern": "^organizations/[^/]+$" }, "expand": { "description": "Set to 'true' to get expanded details about each custom report.", "type": "boolean", "location": "query" } }, "path": "v1/{+parent}/reports", "id": "apigee.organizations.reports.list", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "response": { "$ref": "GoogleCloudApigeeV1ListCustomReportsResponse" }, "parameterOrder": [ "parent" ], "flatPath": "v1/organizations/{organizationsId}/reports", "description": "Return a list of Custom Reports" } } }, "keyvaluemaps": { "resources": { "entries": { "methods": { "create": { "description": "Creates key value entries in a key value map scoped to an organization, environment, or API proxy. **Note**: Supported for Apigee hybrid 1.8.x and higher.", "id": "apigee.organizations.keyvaluemaps.entries.create", "request": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "flatPath": "v1/organizations/{organizationsId}/keyvaluemaps/{keyvaluemapsId}/entries", "parameters": { "parent": { "pattern": "^organizations/[^/]+/keyvaluemaps/[^/]+$", "required": true, "description": "Required. Scope as indicated by the URI in which to create the key value map entry. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", "location": "path", "type": "string" } }, "path": "v1/{+parent}/entries", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "id": "apigee.organizations.keyvaluemaps.entries.list", "httpMethod": "GET", "parameterOrder": [ "parent" ], "description": "Lists key value entries for key values maps scoped to an organization, environment, or API proxy. **Note**: Supported for Apigee hybrid 1.8.x and higher.", "path": "v1/{+parent}/entries", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1ListKeyValueEntriesResponse" }, "flatPath": "v1/organizations/{organizationsId}/keyvaluemaps/{keyvaluemapsId}/entries", "parameters": { "parent": { "location": "path", "type": "string", "description": "Required. Scope as indicated by the URI in which to list key value maps. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", "required": true, "pattern": "^organizations/[^/]+/keyvaluemaps/[^/]+$" }, "pageSize": { "description": "Optional. Maximum number of key value entries to return. If unspecified, at most 100 entries will be returned.", "type": "integer", "format": "int32", "location": "query" }, "pageToken": { "location": "query", "description": "Optional. Page token. If provides, must be a valid key value entry returned from a previous call that can be used to retrieve the next page.", "type": "string" } } }, "update": { "response": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "flatPath": "v1/organizations/{organizationsId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}", "description": "Update key value entry scoped to an organization, environment, or API proxy for an existing key.", "path": "v1/{+name}", "id": "apigee.organizations.keyvaluemaps.entries.update", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "Required. Scope as indicated by the URI in which to create the key value map entry. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}`.", "type": "string", "required": true, "location": "path", "pattern": "^organizations/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$" } }, "request": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "httpMethod": "PUT" }, "delete": { "parameters": { "name": { "location": "path", "description": "Required. Scope as indicated by the URI in which to delete the key value map entry. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`.", "type": "string", "required": true, "pattern": "^organizations/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$" } }, "response": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "parameterOrder": [ "name" ], "description": "Deletes a key value entry from a key value map scoped to an organization, environment, or API proxy. **Notes:** * After you delete the key value entry, the policy consuming the entry will continue to function with its cached values for a few minutes. This is expected behavior. * Supported for Apigee hybrid 1.8.x and higher.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "flatPath": "v1/organizations/{organizationsId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}", "id": "apigee.organizations.keyvaluemaps.entries.delete", "path": "v1/{+name}" }, "get": { "path": "v1/{+name}", "id": "apigee.organizations.keyvaluemaps.entries.get", "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}", "response": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "parameterOrder": [ "name" ], "parameters": { "name": { "pattern": "^organizations/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$", "description": "Required. Scope as indicated by the URI in which to fetch the key value map entry/value. Use **one** of the following structures in your request: * `organizations/{organization}/apis/{api}/keyvaluemaps/{keyvaluemap}/entries/{entry}`. * `organizations/{organization}/environments/{environment}/keyvaluemaps/{keyvaluemap}/entries/{entry}` * `organizations/{organization}/keyvaluemaps/{keyvaluemap}/entries/{entry}`.", "required": true, "location": "path", "type": "string" } }, "description": "Get the key value entry value for a key value map scoped to an organization, environment, or API proxy. **Note**: Supported for Apigee hybrid 1.8.x and higher.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } } }, "methods": { "create": { "parameters": { "parent": { "location": "path", "type": "string", "pattern": "^organizations/[^/]+$", "required": true, "description": "Required. Name of the organization in which to create the key value map file. Use the following structure in your request: `organizations/{org}`" } }, "response": { "$ref": "GoogleCloudApigeeV1KeyValueMap" }, "description": "Creates a key value map in an organization.", "path": "v1/{+parent}/keyvaluemaps", "request": { "$ref": "GoogleCloudApigeeV1KeyValueMap" }, "parameterOrder": [ "parent" ], "id": "apigee.organizations.keyvaluemaps.create", "flatPath": "v1/organizations/{organizationsId}/keyvaluemaps", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "parameters": { "name": { "location": "path", "description": "Required. Name of the key value map. Use the following structure in your request: `organizations/{org}/keyvaluemaps/{keyvaluemap}`", "pattern": "^organizations/[^/]+/keyvaluemaps/[^/]+$", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "description": "Deletes a key value map from an organization.", "httpMethod": "DELETE", "path": "v1/{+name}", "response": { "$ref": "GoogleCloudApigeeV1KeyValueMap" }, "id": "apigee.organizations.keyvaluemaps.delete", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/keyvaluemaps/{keyvaluemapsId}" } } }, "instances": { "methods": { "patch": { "id": "apigee.organizations.instances.patch", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Updates an Apigee runtime instance. You can update the fields described in NodeConfig. No other fields will be updated. **Note:** Not supported for Apigee hybrid.", "path": "v1/{+name}", "request": { "$ref": "GoogleCloudApigeeV1Instance" }, "parameters": { "name": { "description": "Required. Name of the instance. Use the following structure in your request: `organizations/{org}/instances/{instance}`.", "type": "string", "location": "path", "required": true, "pattern": "^organizations/[^/]+/instances/[^/]+$" }, "updateMask": { "type": "string", "description": "List of fields to be updated.", "format": "google-fieldmask", "location": "query" } }, "httpMethod": "PATCH", "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ] }, "list": { "parameterOrder": [ "parent" ], "path": "v1/{+parent}/instances", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1ListInstancesResponse" }, "httpMethod": "GET", "parameters": { "pageToken": { "location": "query", "description": "Page token, returned from a previous ListInstances call, that you can use to retrieve the next page of content.", "type": "string" }, "pageSize": { "format": "int32", "type": "integer", "description": "Maximum number of instances to return. Defaults to 25.", "location": "query" }, "parent": { "pattern": "^organizations/[^/]+$", "description": "Required. Name of the organization. Use the following structure in your request: `organizations/{org}`.", "location": "path", "type": "string", "required": true } }, "id": "apigee.organizations.instances.list", "description": "Lists all Apigee runtime instances for the organization. **Note:** Not supported for Apigee hybrid.", "flatPath": "v1/organizations/{organizationsId}/instances" }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes an Apigee runtime instance. The instance stops serving requests and the runtime data is deleted. **Note:** Not supported for Apigee hybrid.", "parameters": { "name": { "required": true, "type": "string", "description": "Required. Name of the instance. Use the following structure in your request: `organizations/{org}/instances/{instance}`.", "location": "path", "pattern": "^organizations/[^/]+/instances/[^/]+$" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "httpMethod": "DELETE", "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}", "id": "apigee.organizations.instances.delete" }, "get": { "response": { "$ref": "GoogleCloudApigeeV1Instance" }, "parameterOrder": [ "name" ], "id": "apigee.organizations.instances.get", "description": "Gets the details for an Apigee runtime instance. **Note:** Not supported for Apigee hybrid.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "Required. Name of the instance. Use the following structure in your request: `organizations/{org}/instances/{instance}`.", "pattern": "^organizations/[^/]+/instances/[^/]+$", "type": "string", "required": true, "location": "path" } }, "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}", "httpMethod": "GET" }, "reportStatus": { "description": "Reports the latest status for a runtime instance.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.instances.reportStatus", "httpMethod": "POST", "request": { "$ref": "GoogleCloudApigeeV1ReportInstanceStatusRequest" }, "response": { "$ref": "GoogleCloudApigeeV1ReportInstanceStatusResponse" }, "parameterOrder": [ "instance" ], "parameters": { "instance": { "type": "string", "description": "The name of the instance reporting this status. For SaaS the request will be rejected if no instance exists under this name. Format is organizations/{org}/instances/{instance}", "pattern": "^organizations/[^/]+/instances/[^/]+$", "location": "path", "required": true } }, "path": "v1/{+instance}:reportStatus", "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}:reportStatus" }, "create": { "flatPath": "v1/organizations/{organizationsId}/instances", "httpMethod": "POST", "request": { "$ref": "GoogleCloudApigeeV1Instance" }, "path": "v1/{+parent}/instances", "parameterOrder": [ "parent" ], "parameters": { "parent": { "type": "string", "pattern": "^organizations/[^/]+$", "required": true, "description": "Required. Name of the organization. Use the following structure in your request: `organizations/{org}`.", "location": "path" } }, "id": "apigee.organizations.instances.create", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Creates an Apigee runtime instance. The instance is accessible from the authorized network configured on the organization. **Note:** Not supported for Apigee hybrid." } }, "resources": { "natAddresses": { "methods": { "get": { "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}/natAddresses/{natAddressesId}", "id": "apigee.organizations.instances.natAddresses.get", "response": { "$ref": "GoogleCloudApigeeV1NatAddress" }, "description": "Gets the details of a NAT address. **Note:** Not supported for Apigee hybrid.", "httpMethod": "GET", "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "pattern": "^organizations/[^/]+/instances/[^/]+/natAddresses/[^/]+$", "type": "string", "description": "Required. Name of the nat address. Use the following structure in your request: `organizations/{org}/instances/{instances}/natAddresses/{nataddress}`", "required": true, "location": "path" } } }, "activate": { "request": { "$ref": "GoogleCloudApigeeV1ActivateNatAddressRequest" }, "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "required": true, "description": "Required. Name of the nat address. Use the following structure in your request: `organizations/{org}/instances/{instances}/natAddresses/{nataddress}``", "pattern": "^organizations/[^/]+/instances/[^/]+/natAddresses/[^/]+$", "location": "path" } }, "description": "Activates the NAT address. The Apigee instance can now use this for Internet egress traffic. **Note:** Not supported for Apigee hybrid.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}/natAddresses/{natAddressesId}:activate", "httpMethod": "POST", "id": "apigee.organizations.instances.natAddresses.activate", "path": "v1/{+name}:activate" }, "create": { "id": "apigee.organizations.instances.natAddresses.create", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Creates a NAT address. The address is created in the RESERVED state and a static external IP address will be provisioned. At this time, the instance will not use this IP address for Internet egress traffic. The address can be activated for use once any required firewall IP whitelisting has been completed. **Note:** Not supported for Apigee hybrid.", "path": "v1/{+parent}/natAddresses", "request": { "$ref": "GoogleCloudApigeeV1NatAddress" }, "parameters": { "parent": { "pattern": "^organizations/[^/]+/instances/[^/]+$", "location": "path", "type": "string", "description": "Required. Name of the instance. Use the following structure in your request: `organizations/{org}/instances/{instance}`", "required": true } }, "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}/natAddresses" }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes the NAT address. Connections that are actively using the address are drained before it is removed. **Note:** Not supported for Apigee hybrid.", "id": "apigee.organizations.instances.natAddresses.delete", "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "type": "string", "required": true, "pattern": "^organizations/[^/]+/instances/[^/]+/natAddresses/[^/]+$", "description": "Required. Name of the nat address. Use the following structure in your request: `organizations/{org}/instances/{instances}/natAddresses/{nataddress}``" } }, "parameterOrder": [ "name" ], "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}/natAddresses/{natAddressesId}" }, "list": { "response": { "$ref": "GoogleCloudApigeeV1ListNatAddressesResponse" }, "path": "v1/{+parent}/natAddresses", "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}/natAddresses", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "type": "string", "location": "path", "pattern": "^organizations/[^/]+/instances/[^/]+$", "required": true, "description": "Required. Name of the instance. Use the following structure in your request: `organizations/{org}/instances/{instance}`" }, "pageSize": { "description": "Maximum number of natAddresses to return. Defaults to 25.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "type": "string", "location": "query", "description": "Page token, returned from a previous ListNatAddresses call, that you can use to retrieve the next page of content." } }, "parameterOrder": [ "parent" ], "id": "apigee.organizations.instances.natAddresses.list", "httpMethod": "GET", "description": "Lists the NAT addresses for an Apigee instance. **Note:** Not supported for Apigee hybrid." } } }, "canaryevaluations": { "methods": { "create": { "request": { "$ref": "GoogleCloudApigeeV1CanaryEvaluation" }, "id": "apigee.organizations.instances.canaryevaluations.create", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "type": "string", "location": "path", "description": "Required. Name of the organization. Use the following structure in your request: `organizations/{org}/instances/{instance}`.", "pattern": "^organizations/[^/]+/instances/[^/]+$", "required": true } }, "httpMethod": "POST", "parameterOrder": [ "parent" ], "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}/canaryevaluations", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Creates a new canary evaluation for an organization.", "path": "v1/{+parent}/canaryevaluations" }, "get": { "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}/canaryevaluations/{canaryevaluationsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1CanaryEvaluation" }, "path": "v1/{+name}", "parameterOrder": [ "name" ], "parameters": { "name": { "description": "Required. Name of the CanaryEvaluation. Use the following structure in your request: `organizations/{org}/instances/*/canaryevaluations/{evaluation}`", "required": true, "pattern": "^organizations/[^/]+/instances/[^/]+/canaryevaluations/[^/]+$", "location": "path", "type": "string" } }, "description": "Gets a CanaryEvaluation for an organization.", "httpMethod": "GET", "id": "apigee.organizations.instances.canaryevaluations.get" } } }, "attachments": { "methods": { "delete": { "id": "apigee.organizations.instances.attachments.delete", "description": "Deletes an attachment. **Note:** Not supported for Apigee hybrid.", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^organizations/[^/]+/instances/[^/]+/attachments/[^/]+$", "description": "Required. Name of the attachment. Use the following structure in your request: `organizations/{org}/instances/{instance}/attachments/{attachment}`." } }, "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "httpMethod": "DELETE", "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}/attachments/{attachmentsId}", "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "type": "string", "pattern": "^organizations/[^/]+/instances/[^/]+/attachments/[^/]+$", "required": true, "description": "Required. Name of the attachment. Use the following structure in your request: `organizations/{org}/instances/{instance}/attachments/{attachment}`" } }, "description": "Gets an attachment. **Note:** Not supported for Apigee hybrid.", "id": "apigee.organizations.instances.attachments.get", "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}/attachments/{attachmentsId}", "response": { "$ref": "GoogleCloudApigeeV1InstanceAttachment" } }, "list": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.instances.attachments.list", "description": "Lists all attachments to an instance. **Note:** Not supported for Apigee hybrid.", "parameters": { "pageToken": { "type": "string", "description": "Page token, returned by a previous ListInstanceAttachments call, that you can use to retrieve the next page of content.", "location": "query" }, "pageSize": { "format": "int32", "type": "integer", "description": "Maximum number of instance attachments to return. Defaults to 25.", "location": "query" }, "parent": { "location": "path", "type": "string", "description": "Required. Name of the organization. Use the following structure in your request: `organizations/{org}/instances/{instance}`", "required": true, "pattern": "^organizations/[^/]+/instances/[^/]+$" } }, "response": { "$ref": "GoogleCloudApigeeV1ListInstanceAttachmentsResponse" }, "path": "v1/{+parent}/attachments", "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}/attachments", "parameterOrder": [ "parent" ] }, "create": { "path": "v1/{+parent}/attachments", "parameters": { "parent": { "location": "path", "type": "string", "pattern": "^organizations/[^/]+/instances/[^/]+$", "required": true, "description": "Required. Name of the instance. Use the following structure in your request: `organizations/{org}/instances/{instance}`." } }, "parameterOrder": [ "parent" ], "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}/attachments", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Creates a new attachment of an environment to an instance. **Note:** Not supported for Apigee hybrid.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "id": "apigee.organizations.instances.attachments.create", "request": { "$ref": "GoogleCloudApigeeV1InstanceAttachment" } } } } } }, "hostStats": { "methods": { "get": { "flatPath": "v1/organizations/{organizationsId}/hostStats/{hostStatsId}", "response": { "$ref": "GoogleCloudApigeeV1Stats" }, "httpMethod": "GET", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.hostStats.get", "path": "v1/{+name}", "parameters": { "name": { "required": true, "pattern": "^organizations/[^/]+/hostStats/.*$", "type": "string", "description": "Required. Resource name for which the interactive query will be executed. Use the following format in your request: `organizations/{org}/hostStats/{dimensions}` Dimensions let you view metrics in meaningful groupings, such as `apiproxy`, `target_host`. The value of dimensions should be a comma-separated list as shown below `organizations/{org}/hostStats/apiproxy,request_verb`", "location": "path" }, "timeRange": { "location": "query", "type": "string", "description": "Time interval for the interactive query. Time range is specified in GMT as `start~end`. For example: `04/15/2017 00:00~05/15/2017 23:59`" }, "select": { "location": "query", "type": "string", "description": "Comma-separated list of metrics. For example: `sum(message_count),sum(error_count)`" }, "envgroupHostname": { "type": "string", "location": "query", "description": "Required. Hostname for which the interactive query will be executed." }, "timeUnit": { "location": "query", "type": "string", "description": "Granularity of metrics returned. Valid values include: `second`, `minute`, `hour`, `day`, `week`, or `month`." }, "limit": { "type": "string", "description": "Maximum number of result items to return. The default and maximum value that can be returned is 14400.", "location": "query" }, "filter": { "type": "string", "description": "Flag that enables drill-down on specific dimension values.", "location": "query" }, "tzo": { "type": "string", "description": "Timezone offset value.", "location": "query" }, "tsAscending": { "location": "query", "description": "Flag that specifies whether to list timestamps in ascending (`true`) or descending (`false`) order. Apigee recommends that you set this value to `true` if you are using `sortby` with `sort=DESC`.", "type": "boolean" }, "sort": { "type": "string", "location": "query", "description": "Flag that specifies if the sort order should be ascending or descending. Valid values are `DESC` and `ASC`." }, "offset": { "type": "string", "description": "Offset value. Use `offset` with `limit` to enable pagination of results. For example, to display results 11-20, set limit to `10` and offset to `10`.", "location": "query" }, "realtime": { "location": "query", "type": "boolean", "description": "No longer used by Apigee. Supported for backwards compatibility." }, "sortby": { "location": "query", "type": "string", "description": "Comma-separated list of columns to sort the final result." }, "accuracy": { "description": "No longer used by Apigee. Supported for backwards compatibility.", "type": "string", "location": "query" }, "topk": { "type": "string", "description": "Top number of results to return. For example, to return the top 5 results, set `topk=5`.", "location": "query" } }, "description": "Retrieve metrics grouped by dimensions in host level. The types of metrics you can retrieve include traffic, message counts, API call latency, response size, and cache hits and counts. Dimensions let you view metrics in meaningful groups. You can optionally pass dimensions as path parameters to the `stats` API. If dimensions are not specified, the metrics are computed on the entire set of data for the given time range." } } }, "sharedflows": { "resources": { "deployments": { "methods": { "list": { "flatPath": "v1/organizations/{organizationsId}/sharedflows/{sharedflowsId}/deployments", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/deployments", "description": "Lists all deployments of a shared flow.", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.sharedflows.deployments.list", "response": { "$ref": "GoogleCloudApigeeV1ListDeploymentsResponse" }, "parameters": { "parent": { "location": "path", "description": "Required. Name of the shared flow for which to return deployment information in the following format: `organizations/{org}/sharedflows/{sharedflow}`", "required": true, "type": "string", "pattern": "^organizations/[^/]+/sharedflows/[^/]+$" } } } } }, "revisions": { "methods": { "updateSharedFlowRevision": { "description": "Updates a shared flow revision. This operation is only allowed on revisions which have never been deployed. After deployment a revision becomes immutable, even if it becomes undeployed. The payload is a ZIP-formatted shared flow. Content type must be either multipart/form-data or application/octet-stream.", "id": "apigee.organizations.sharedflows.revisions.updateSharedFlowRevision", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1SharedFlowRevision" }, "parameterOrder": [ "name" ], "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/sharedflows/{sharedflowsId}/revisions/{revisionsId}", "httpMethod": "POST", "parameters": { "validate": { "type": "boolean", "description": "Ignored. All uploads are validated regardless of the value of this field. It is kept for compatibility with existing APIs. Must be `true` or `false` if provided.", "location": "query" }, "name": { "location": "path", "description": "Required. The name of the shared flow revision to update. Must be of the form: `organizations/{organization_id}/sharedflows/{shared_flow_id}/revisions/{revision_id}`", "required": true, "pattern": "^organizations/[^/]+/sharedflows/[^/]+/revisions/[^/]+$", "type": "string" } }, "request": { "$ref": "GoogleApiHttpBody" } }, "get": { "response": { "$ref": "GoogleApiHttpBody" }, "httpMethod": "GET", "parameters": { "format": { "type": "string", "location": "query", "description": "Specify `bundle` to export the contents of the shared flow bundle. Otherwise, the bundle metadata is returned." }, "name": { "description": "Required. The name of the shared flow revision to get. Must be of the form: `organizations/{organization_id}/sharedflows/{shared_flow_id}/revisions/{revision_id}`", "required": true, "type": "string", "pattern": "^organizations/[^/]+/sharedflows/[^/]+/revisions/[^/]+$", "location": "path" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "id": "apigee.organizations.sharedflows.revisions.get", "description": "Gets a revision of a shared flow. To download the shared flow configuration bundle for the specified revision as a zip file, set the `format` query parameter to `bundle`. If you are using curl, specify `-o filename.zip` to save the output to a file; otherwise, it displays to `stdout`. Then, develop the shared flow configuration locally and upload the updated sharedFlow configuration revision, as described in [updateSharedFlowRevision](updateSharedFlowRevision).", "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/sharedflows/{sharedflowsId}/revisions/{revisionsId}" }, "delete": { "parameters": { "name": { "pattern": "^organizations/[^/]+/sharedflows/[^/]+/revisions/[^/]+$", "type": "string", "description": "Required. The name of the shared flow revision to delete. Must be of the form: `organizations/{organization_id}/sharedflows/{shared_flow_id}/revisions/{revision_id}`", "location": "path", "required": true } }, "httpMethod": "DELETE", "flatPath": "v1/organizations/{organizationsId}/sharedflows/{sharedflowsId}/revisions/{revisionsId}", "description": "Deletes a shared flow and all associated policies, resources, and revisions. You must undeploy the shared flow before deleting it.", "path": "v1/{+name}", "id": "apigee.organizations.sharedflows.revisions.delete", "response": { "$ref": "GoogleCloudApigeeV1SharedFlowRevision" }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } }, "resources": { "deployments": { "methods": { "list": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.sharedflows.revisions.deployments.list", "parameters": { "parent": { "location": "path", "description": "Required. Name of the API proxy revision for which to return deployment information in the following format: `organizations/{org}/sharedflows/{sharedflow}/revisions/{rev}`.", "required": true, "type": "string", "pattern": "^organizations/[^/]+/sharedflows/[^/]+/revisions/[^/]+$" } }, "response": { "$ref": "GoogleCloudApigeeV1ListDeploymentsResponse" }, "flatPath": "v1/organizations/{organizationsId}/sharedflows/{sharedflowsId}/revisions/{revisionsId}/deployments", "parameterOrder": [ "parent" ], "description": "Lists all deployments of a shared flow revision.", "httpMethod": "GET", "path": "v1/{+parent}/deployments" } } } } } }, "methods": { "create": { "flatPath": "v1/organizations/{organizationsId}/sharedflows", "response": { "$ref": "GoogleCloudApigeeV1SharedFlowRevision" }, "parameters": { "parent": { "location": "path", "description": "Required. The name of the parent organization under which to create the shared flow. Must be of the form: `organizations/{organization_id}`", "required": true, "pattern": "^organizations/[^/]+$", "type": "string" }, "action": { "description": "Required. Must be set to either `import` or `validate`.", "type": "string", "location": "query" }, "name": { "type": "string", "location": "query", "description": "Required. The name to give the shared flow" } }, "httpMethod": "POST", "id": "apigee.organizations.sharedflows.create", "description": "Uploads a ZIP-formatted shared flow configuration bundle to an organization. If the shared flow already exists, this creates a new revision of it. If the shared flow does not exist, this creates it. Once imported, the shared flow revision must be deployed before it can be accessed at runtime. The size limit of a shared flow bundle is 15 MB.", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/sharedflows", "request": { "$ref": "GoogleApiHttpBody" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "description": "Deletes a shared flow and all it's revisions. The shared flow must be undeployed before you can delete it.", "parameters": { "name": { "type": "string", "required": true, "description": "Required. shared flow name of the form: `organizations/{organization_id}/sharedflows/{shared_flow_id}`", "pattern": "^organizations/[^/]+/sharedflows/[^/]+$", "location": "path" } }, "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1SharedFlow" }, "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/sharedflows/{sharedflowsId}", "id": "apigee.organizations.sharedflows.delete" }, "get": { "parameterOrder": [ "name" ], "httpMethod": "GET", "id": "apigee.organizations.sharedflows.get", "parameters": { "name": { "description": "Required. The name of the shared flow to get. Must be of the form: `organizations/{organization_id}/sharedflows/{shared_flow_id}`", "pattern": "^organizations/[^/]+/sharedflows/[^/]+$", "location": "path", "required": true, "type": "string" } }, "response": { "$ref": "GoogleCloudApigeeV1SharedFlow" }, "flatPath": "v1/organizations/{organizationsId}/sharedflows/{sharedflowsId}", "description": "Gets a shared flow by name, including a list of its revisions.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}" }, "list": { "id": "apigee.organizations.sharedflows.list", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/sharedflows", "description": "Lists all shared flows in the organization.", "path": "v1/{+parent}/sharedflows", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ListSharedFlowsResponse" }, "httpMethod": "GET", "parameters": { "includeRevisions": { "description": "Indicates whether to include a list of revisions in the response.", "location": "query", "type": "boolean" }, "includeMetaData": { "description": "Indicates whether to include shared flow metadata in the response.", "location": "query", "type": "boolean" }, "parent": { "location": "path", "pattern": "^organizations/[^/]+$", "required": true, "description": "Required. The name of the parent organization under which to get shared flows. Must be of the form: `organizations/{organization_id}`", "type": "string" } } } } }, "analytics": { "resources": { "datastores": { "methods": { "create": { "parameters": { "parent": { "required": true, "location": "path", "type": "string", "description": "Required. The parent organization name. Must be of the form `organizations/{org}`.", "pattern": "^organizations/[^/]+$" } }, "parameterOrder": [ "parent" ], "description": "Create a Datastore for an org", "id": "apigee.organizations.analytics.datastores.create", "response": { "$ref": "GoogleCloudApigeeV1Datastore" }, "httpMethod": "POST", "flatPath": "v1/organizations/{organizationsId}/analytics/datastores", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudApigeeV1Datastore" }, "path": "v1/{+parent}/analytics/datastores" }, "get": { "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/analytics/datastores/{datastoresId}", "parameterOrder": [ "name" ], "path": "v1/{+name}", "description": "Get a Datastore", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.analytics.datastores.get", "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Required. Resource name of the Datastore to be get. Must be of the form `organizations/{org}/analytics/datastores/{datastoreId}`", "pattern": "^organizations/[^/]+/analytics/datastores/[^/]+$" } }, "response": { "$ref": "GoogleCloudApigeeV1Datastore" } }, "delete": { "id": "apigee.organizations.analytics.datastores.delete", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "required": true, "pattern": "^organizations/[^/]+/analytics/datastores/[^/]+$", "location": "path", "description": "Required. Resource name of the Datastore to be deleted. Must be of the form `organizations/{org}/analytics/datastores/{datastoreId}`", "type": "string" } }, "httpMethod": "DELETE", "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1/{+name}", "parameterOrder": [ "name" ], "description": "Delete a Datastore from an org.", "flatPath": "v1/organizations/{organizationsId}/analytics/datastores/{datastoresId}" }, "list": { "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "targetType": { "location": "query", "description": "Optional. TargetType is used to fetch all Datastores that match the type", "type": "string" }, "parent": { "type": "string", "required": true, "location": "path", "pattern": "^organizations/[^/]+$", "description": "Required. The parent organization name. Must be of the form `organizations/{org}`." } }, "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ListDatastoresResponse" }, "path": "v1/{+parent}/analytics/datastores", "id": "apigee.organizations.analytics.datastores.list", "flatPath": "v1/organizations/{organizationsId}/analytics/datastores", "description": "List Datastores" }, "update": { "response": { "$ref": "GoogleCloudApigeeV1Datastore" }, "parameters": { "name": { "description": "Required. The resource name of datastore to be updated. Must be of the form `organizations/{org}/analytics/datastores/{datastoreId}`", "pattern": "^organizations/[^/]+/analytics/datastores/[^/]+$", "location": "path", "required": true, "type": "string" } }, "httpMethod": "PUT", "id": "apigee.organizations.analytics.datastores.update", "request": { "$ref": "GoogleCloudApigeeV1Datastore" }, "path": "v1/{+name}", "description": "Update a Datastore", "flatPath": "v1/organizations/{organizationsId}/analytics/datastores/{datastoresId}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "test": { "parameterOrder": [ "parent" ], "parameters": { "parent": { "location": "path", "description": "Required. The parent organization name Must be of the form `organizations/{org}`", "required": true, "type": "string", "pattern": "^organizations/[^/]+$" } }, "response": { "$ref": "GoogleCloudApigeeV1TestDatastoreResponse" }, "id": "apigee.organizations.analytics.datastores.test", "flatPath": "v1/organizations/{organizationsId}/analytics/datastores:test", "httpMethod": "POST", "description": "Test if Datastore configuration is correct. This includes checking if credentials provided by customer have required permissions in target destination storage", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+parent}/analytics/datastores:test", "request": { "$ref": "GoogleCloudApigeeV1Datastore" } } } } } } }, "methods": { "create": { "description": "Creates an Apigee organization. See [Create an Apigee organization](https://cloud.google.com/apigee/docs/api-platform/get-started/create-org).", "parameterOrder": [], "parameters": { "parent": { "type": "string", "location": "query", "description": "Required. Name of the Google Cloud project in which to associate the Apigee organization. Pass the information as a query parameter using the following structure in your request: `projects/`" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.create", "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "POST", "request": { "$ref": "GoogleCloudApigeeV1Organization" }, "path": "v1/organizations", "flatPath": "v1/organizations" }, "setAddons": { "response": { "$ref": "GoogleLongrunningOperation" }, "id": "apigee.organizations.setAddons", "request": { "$ref": "GoogleCloudApigeeV1SetAddonsRequest" }, "description": "Configures the add-ons for the Apigee organization. The existing add-on configuration will be fully replaced.", "parameters": { "org": { "description": "Required. Name of the organization. Use the following structure in your request: `organizations/{org}`", "pattern": "^organizations/[^/]+$", "location": "path", "type": "string", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "flatPath": "v1/organizations/{organizationsId}:setAddons", "parameterOrder": [ "org" ], "path": "v1/{+org}:setAddons" }, "list": { "httpMethod": "GET", "id": "apigee.organizations.list", "path": "v1/{+parent}", "flatPath": "v1/organizations", "parameters": { "parent": { "description": "Required. Use the following structure in your request: `organizations`", "type": "string", "required": true, "pattern": "^organizations$", "location": "path" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists the Apigee organizations and associated Google Cloud projects that you have permission to access. See [Understanding organizations](https://cloud.google.com/apigee/docs/api-platform/fundamentals/organization-structure).", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ListOrganizationsResponse" } }, "delete": { "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.delete", "path": "v1/{+name}", "parameters": { "retention": { "description": "Optional. This setting is applicable only for organizations that are soft-deleted (i.e., BillingType is not EVALUATION). It controls how long Organization data will be retained after the initial delete operation completes. During this period, the Organization may be restored to its last known state. After this period, the Organization will no longer be able to be restored. **Note: During the data retention period specified using this field, the Apigee organization cannot be recreated in the same GCP project.**", "location": "query", "enum": [ "DELETION_RETENTION_UNSPECIFIED", "MINIMUM" ], "enumDescriptions": [ "Default data retention setting of seven days will be applied.", "Organization data will be retained for the minimum period of 24 hours." ], "type": "string" }, "name": { "description": "Required. Name of the organization. Use the following structure in your request: `organizations/{org}`", "required": true, "pattern": "^organizations/[^/]+$", "location": "path", "type": "string" } }, "httpMethod": "DELETE", "description": "Delete an Apigee organization. For organizations with BillingType EVALUATION, an immediate deletion is performed. For paid organizations (Subscription or Pay-as-you-go), a soft-deletion is performed. The organization can be restored within the soft-deletion period, which is specified using the `retention` field in the request or by filing a support ticket with Apigee. During the data retention period specified in the request, the Apigee organization cannot be recreated in the same Google Cloud project. **IMPORTANT: The default data retention setting for this operation is 7 days. To permanently delete the organization in 24 hours, set the retention parameter to `MINIMUM`.**", "flatPath": "v1/organizations/{organizationsId}", "parameterOrder": [ "name" ] }, "getDeployedIngressConfig": { "path": "v1/{+name}", "parameters": { "view": { "enumDescriptions": [ "The default/unset value. The API will default to the BASIC view.", "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.", "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." ], "description": "When set to FULL, additional details about the specific deployments receiving traffic will be included in the IngressConfig response's RoutingRules.", "type": "string", "location": "query", "enum": [ "INGRESS_CONFIG_VIEW_UNSPECIFIED", "BASIC", "FULL" ] }, "name": { "required": true, "location": "path", "pattern": "^organizations/[^/]+/deployedIngressConfig$", "type": "string", "description": "Required. Name of the deployed configuration for the organization in the following format: 'organizations/{org}/deployedIngressConfig'." } }, "flatPath": "v1/organizations/{organizationsId}/deployedIngressConfig", "response": { "$ref": "GoogleCloudApigeeV1IngressConfig" }, "id": "apigee.organizations.getDeployedIngressConfig", "httpMethod": "GET", "description": "Gets the deployed ingress configuration for an organization.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "setSyncAuthorization": { "description": "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.", "request": { "$ref": "GoogleCloudApigeeV1SyncAuthorization" }, "parameterOrder": [ "name" ], "httpMethod": "POST", "parameters": { "name": { "required": true, "location": "path", "type": "string", "description": "Required. Name of the Apigee organization. Use the following structure in your request: `organizations/{org}`", "pattern": "^organizations/[^/]+$" } }, "id": "apigee.organizations.setSyncAuthorization", "response": { "$ref": "GoogleCloudApigeeV1SyncAuthorization" }, "path": "v1/{+name}:setSyncAuthorization", "flatPath": "v1/organizations/{organizationsId}:setSyncAuthorization", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "update": { "request": { "$ref": "GoogleCloudApigeeV1Organization" }, "description": "Updates the properties for an Apigee organization. No other fields in the organization profile will be updated.", "httpMethod": "PUT", "flatPath": "v1/organizations/{organizationsId}", "id": "apigee.organizations.update", "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "description": "Required. Apigee organization name in the following format: `organizations/{org}`", "pattern": "^organizations/[^/]+$", "type": "string", "required": true } }, "response": { "$ref": "GoogleCloudApigeeV1Organization" }, "parameterOrder": [ "name" ] }, "getProjectMapping": { "flatPath": "v1/organizations/{organizationsId}:getProjectMapping", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudApigeeV1OrganizationProjectMapping" }, "httpMethod": "GET", "path": "v1/{+name}:getProjectMapping", "description": "Gets the project ID and region for an Apigee organization.", "parameters": { "name": { "description": "Required. Apigee organization name in the following format: `organizations/{org}`", "pattern": "^organizations/[^/]+$", "required": true, "location": "path", "type": "string" } }, "parameterOrder": [ "name" ], "id": "apigee.organizations.getProjectMapping" }, "updateSecuritySettings": { "request": { "$ref": "GoogleCloudApigeeV1SecuritySettings" }, "description": "UpdateSecuritySettings updates the current security settings for API Security.", "parameters": { "updateMask": { "location": "query", "format": "google-fieldmask", "description": "Optional. The list of fields to update. Allowed fields are: - ml_retraining_feedback_enabled", "type": "string" }, "name": { "pattern": "^organizations/[^/]+/securitySettings$", "type": "string", "description": "Identifier. Full resource name is always `organizations/{org}/securitySettings`.", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "PATCH", "response": { "$ref": "GoogleCloudApigeeV1SecuritySettings" }, "id": "apigee.organizations.updateSecuritySettings", "path": "v1/{+name}", "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/securitySettings" }, "getRuntimeConfig": { "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Get runtime config for an organization.", "parameters": { "name": { "location": "path", "type": "string", "description": "Required. Name of the runtime config for the organization in the following format: 'organizations/{org}/runtimeConfig'.", "pattern": "^organizations/[^/]+/runtimeConfig$", "required": true } }, "httpMethod": "GET", "response": { "$ref": "GoogleCloudApigeeV1RuntimeConfig" }, "id": "apigee.organizations.getRuntimeConfig", "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/runtimeConfig" }, "get": { "response": { "$ref": "GoogleCloudApigeeV1Organization" }, "path": "v1/{+name}", "parameters": { "name": { "required": true, "location": "path", "pattern": "^organizations/[^/]+$", "type": "string", "description": "Required. Apigee organization name in the following format: `organizations/{org}`" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "id": "apigee.organizations.get", "flatPath": "v1/organizations/{organizationsId}", "parameterOrder": [ "name" ], "description": "Gets the profile for an Apigee organization. See [Understanding organizations](https://cloud.google.com/apigee/docs/api-platform/fundamentals/organization-structure)." }, "getSyncAuthorization": { "response": { "$ref": "GoogleCloudApigeeV1SyncAuthorization" }, "path": "v1/{+name}:getSyncAuthorization", "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}:getSyncAuthorization", "id": "apigee.organizations.getSyncAuthorization", "description": "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.", "request": { "$ref": "GoogleCloudApigeeV1GetSyncAuthorizationRequest" }, "httpMethod": "POST", "parameters": { "name": { "location": "path", "pattern": "^organizations/[^/]+$", "type": "string", "description": "Required. Name of the Apigee organization. Use the following structure in your request: `organizations/{org}`", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "getSecuritySettings": { "id": "apigee.organizations.getSecuritySettings", "response": { "$ref": "GoogleCloudApigeeV1SecuritySettings" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "parameters": { "name": { "description": "Required. The name of the SecuritySettings to retrieve. This will always be: 'organizations/{org}/securitySettings'.", "required": true, "location": "path", "type": "string", "pattern": "^organizations/[^/]+/securitySettings$" } }, "description": "GetSecuritySettings gets the security settings for API Security.", "flatPath": "v1/organizations/{organizationsId}/securitySettings", "httpMethod": "GET", "path": "v1/{+name}" } } }, "projects": { "methods": { "provisionOrganization": { "parameterOrder": [ "project" ], "flatPath": "v1/projects/{projectsId}:provisionOrganization", "id": "apigee.projects.provisionOrganization", "parameters": { "project": { "type": "string", "description": "Required. Name of the GCP project with which to associate the Apigee organization.", "pattern": "^projects/[^/]+$", "required": true, "location": "path" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1/{+project}:provisionOrganization", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudApigeeV1ProvisionOrganizationRequest" }, "description": "Provisions a new Apigee organization with a functioning runtime. This is the standard way to create trial organizations for a free Apigee trial." } } } }, "servicePath": "", "revision": "20240507", "rootUrl": "https://apigee.googleapis.com/", "canonicalName": "Apigee", "schemas": { "GoogleCloudApigeeV1GenerateUploadUrlRequest": { "properties": {}, "description": "Request for GenerateUploadUrl method.", "type": "object", "id": "GoogleCloudApigeeV1GenerateUploadUrlRequest" }, "GoogleCloudApigeeV1GenerateDownloadUrlResponse": { "properties": { "downloadUri": { "type": "string", "description": "The Google Cloud Storage signed URL that can be used to download the Archive zip file." } }, "type": "object", "id": "GoogleCloudApigeeV1GenerateDownloadUrlResponse", "description": "Response for GenerateDownloadUrl method." }, "GoogleCloudApigeeV1ScoreComponentRecommendationAction": { "id": "GoogleCloudApigeeV1ScoreComponentRecommendationAction", "properties": { "actionContext": { "description": "Action context for the action.", "$ref": "GoogleCloudApigeeV1ScoreComponentRecommendationActionActionContext" }, "description": { "type": "string", "description": "Description of the action." } }, "type": "object", "description": "Action to improve security score." }, "GoogleCloudApigeeV1QueryMetadata": { "type": "object", "id": "GoogleCloudApigeeV1QueryMetadata", "properties": { "endTimestamp": { "type": "string", "description": "End timestamp of the query range." }, "outputFormat": { "type": "string", "description": "Output format." }, "metrics": { "description": "Metrics of the AsyncQuery. Example: [\"name:message_count,func:sum,alias:sum_message_count\"]", "type": "array", "items": { "type": "string" } }, "startTimestamp": { "description": "Start timestamp of the query range.", "type": "string" }, "timeUnit": { "description": "Query GroupBy time unit.", "type": "string" }, "dimensions": { "description": "Dimensions of the AsyncQuery.", "type": "array", "items": { "type": "string" } } } }, "GoogleCloudApigeeV1GetAsyncQueryResultUrlResponseURLInfo": { "properties": { "sizeBytes": { "format": "int64", "description": "The size of the returned file in bytes", "type": "string" }, "uri": { "description": "The signed URL of the JSON data. Will be of the form `https://storage.googleapis.com/example-bucket/cat.jpeg?X-Goog-Algorithm= GOOG4-RSA-SHA256&X-Goog-Credential=example%40example-project.iam.gserviceaccount .com%2F20181026%2Fus-central1%2Fstorage%2Fgoog4_request&X-Goog-Date=20181026T18 1309Z&X-Goog-Expires=900&X-Goog-SignedHeaders=host&X-Goog-Signature=247a2aa45f16 9edf4d187d54e7cc46e4731b1e6273242c4f4c39a1d2507a0e58706e25e3a85a7dbb891d62afa849 6def8e260c1db863d9ace85ff0a184b894b117fe46d1225c82f2aa19efd52cf21d3e2022b3b868dc c1aca2741951ed5bf3bb25a34f5e9316a2841e8ff4c530b22ceaa1c5ce09c7cbb5732631510c2058 0e61723f5594de3aea497f195456a2ff2bdd0d13bad47289d8611b6f9cfeef0c46c91a455b94e90a 66924f722292d21e24d31dcfb38ce0c0f353ffa5a9756fc2a9f2b40bc2113206a81e324fc4fd6823 a29163fa845c8ae7eca1fcf6e5bb48b3200983c56c5ca81fffb151cca7402beddfc4a76b13344703 2ea7abedc098d2eb14a7`", "type": "string" }, "md5": { "description": "The MD5 Hash of the JSON data", "type": "string" } }, "id": "GoogleCloudApigeeV1GetAsyncQueryResultUrlResponseURLInfo", "type": "object", "description": "A Signed URL and the relevant metadata associated with it." }, "GoogleCloudApigeeV1Attributes": { "id": "GoogleCloudApigeeV1Attributes", "type": "object", "properties": { "attribute": { "type": "array", "items": { "$ref": "GoogleCloudApigeeV1Attribute" }, "description": "List of attributes." } } }, "GoogleCloudApigeeV1ListEnvironmentGroupAttachmentsResponse": { "description": "Response for ListEnvironmentGroupAttachments.", "properties": { "nextPageToken": { "type": "string", "description": "Page token that you can include in a ListEnvironmentGroupAttachments request to retrieve the next page. If omitted, no subsequent pages exist." }, "environmentGroupAttachments": { "type": "array", "description": "EnvironmentGroupAttachments for the specified environment group.", "items": { "$ref": "GoogleCloudApigeeV1EnvironmentGroupAttachment" } } }, "id": "GoogleCloudApigeeV1ListEnvironmentGroupAttachmentsResponse", "type": "object" }, "GoogleCloudApigeeV1APIProductAssociation": { "properties": { "apiproduct": { "type": "string", "description": "API product to be associated with the credential." }, "status": { "description": "The API product credential associated status. Valid values are `approved` or `revoked`.", "type": "string" } }, "description": "APIProductAssociation has the API product and its administrative state association.", "id": "GoogleCloudApigeeV1APIProductAssociation", "type": "object" }, "GoogleCloudApigeeV1BatchUpdateSecurityIncidentsResponse": { "type": "object", "id": "GoogleCloudApigeeV1BatchUpdateSecurityIncidentsResponse", "properties": { "securityIncidents": { "type": "array", "readOnly": true, "description": "Output only. Updated security incidents", "items": { "$ref": "GoogleCloudApigeeV1SecurityIncident" } } }, "description": "Response for BatchUpdateSecurityIncident." }, "GoogleCloudApigeeV1AccessSet": { "id": "GoogleCloudApigeeV1AccessSet", "properties": { "name": { "type": "string" }, "value": { "type": "string" }, "success": { "type": "boolean" } }, "type": "object", "description": "Set action. For example, \"Set\" : { \"name\" : \"target.name\", \"success\" : true, \"value\" : \"default\" }" }, "GoogleCloudApigeeV1ProfileConfigCategory": { "id": "GoogleCloudApigeeV1ProfileConfigCategory", "properties": { "mtls": { "$ref": "GoogleCloudApigeeV1ProfileConfigMTLS", "description": "Checks to see if you have configured mTLS for the target server." }, "authorization": { "description": "Checks to see if you have an authorization policy in place.", "$ref": "GoogleCloudApigeeV1ProfileConfigAuthorization" }, "abuse": { "$ref": "GoogleCloudApigeeV1ProfileConfigAbuse", "description": "Checks for abuse, which includes any requests sent to the API for purposes other than what it is intended for, such as high volumes of requests, data scraping, and abuse related to authorization." }, "cors": { "description": "Checks to see if you have CORS policy in place.", "$ref": "GoogleCloudApigeeV1ProfileConfigCORS" }, "mediation": { "$ref": "GoogleCloudApigeeV1ProfileConfigMediation", "description": "Checks to see if you have a mediation policy in place." }, "threat": { "$ref": "GoogleCloudApigeeV1ProfileConfigThreat", "description": "Checks to see if you have a threat protection policy in place." } }, "description": "Advanced API Security provides security profile that scores the following categories.", "type": "object" }, "GoogleCloudApigeeV1Access": { "id": "GoogleCloudApigeeV1Access", "properties": { "Set": { "$ref": "GoogleCloudApigeeV1AccessSet" }, "Remove": { "$ref": "GoogleCloudApigeeV1AccessRemove" }, "Get": { "$ref": "GoogleCloudApigeeV1AccessGet" } }, "type": "object" }, "GoogleCloudApigeeV1CertInfo": { "type": "object", "id": "GoogleCloudApigeeV1CertInfo", "description": "X.509 certificate as defined in RFC 5280.", "properties": { "version": { "description": "X.509 version.", "format": "int32", "type": "integer" }, "validFrom": { "type": "string", "format": "int64", "description": "X.509 `notBefore` validity period in milliseconds since epoch." }, "serialNumber": { "type": "string", "description": "X.509 serial number." }, "isValid": { "type": "string", "description": "Flag that specifies whether the certificate is valid. Flag is set to `Yes` if the certificate is valid, `No` if expired, or `Not yet` if not yet valid." }, "basicConstraints": { "type": "string", "description": "X.509 basic constraints extension." }, "sigAlgName": { "type": "string", "description": "X.509 signatureAlgorithm." }, "publicKey": { "description": "Public key component of the X.509 subject public key info.", "type": "string" }, "subject": { "type": "string", "description": "X.509 subject." }, "subjectAlternativeNames": { "description": "X.509 subject alternative names (SANs) extension.", "items": { "type": "string" }, "type": "array" }, "issuer": { "description": "X.509 issuer.", "type": "string" }, "expiryDate": { "description": "X.509 `notAfter` validity period in milliseconds since epoch.", "type": "string", "format": "int64" } } }, "GoogleCloudApigeeV1ProfileConfigAuthorization": { "id": "GoogleCloudApigeeV1ProfileConfigAuthorization", "description": "By default, following policies will be included: - JWS - JWT - OAuth - BasicAuth - APIKey", "properties": {}, "type": "object" }, "GoogleCloudApigeeV1ListNatAddressesResponse": { "id": "GoogleCloudApigeeV1ListNatAddressesResponse", "properties": { "natAddresses": { "description": "List of NAT Addresses for the instance.", "items": { "$ref": "GoogleCloudApigeeV1NatAddress" }, "type": "array" }, "nextPageToken": { "description": "Page token that you can include in a ListNatAddresses request to retrieve the next page of content. If omitted, no subsequent pages exist.", "type": "string" } }, "type": "object", "description": "Response for ListNatAddresses." }, "GoogleCloudApigeeV1SecurityActionFlag": { "description": "The message that should be set in the case of a Flag action.", "id": "GoogleCloudApigeeV1SecurityActionFlag", "type": "object", "properties": { "headers": { "items": { "$ref": "GoogleCloudApigeeV1SecurityActionHttpHeader" }, "type": "array", "description": "Optional. A list of HTTP headers to be sent to the target in case of a FLAG SecurityAction. Limit 5 headers per SecurityAction. At least one is mandatory." } } }, "GoogleCloudApigeeV1GenerateUploadUrlResponse": { "description": "Response for GenerateUploadUrl method.", "type": "object", "id": "GoogleCloudApigeeV1GenerateUploadUrlResponse", "properties": { "uploadUri": { "type": "string", "description": "The Google Cloud Storage signed URL that can be used to upload a new Archive zip file." } } }, "GoogleIamV1SetIamPolicyRequest": { "id": "GoogleIamV1SetIamPolicyRequest", "properties": { "updateMask": { "format": "google-fieldmask", "type": "string", "description": "OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only the fields in the mask will be modified. If no mask is provided, the following default mask is used: `paths: \"bindings, etag\"`" }, "policy": { "description": "REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Google Cloud services (such as Projects) might reject them.", "$ref": "GoogleIamV1Policy" } }, "description": "Request message for `SetIamPolicy` method.", "type": "object" }, "GoogleCloudApigeeV1RoutingRule": { "type": "object", "id": "GoogleCloudApigeeV1RoutingRule", "properties": { "otherTargets": { "items": { "type": "string" }, "description": "Conflicting targets, which will be resource names specifying either deployment groups or environments.", "type": "array" }, "receiver": { "description": "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.", "type": "string" }, "envGroupRevision": { "format": "int64", "type": "string", "description": "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." }, "updateTime": { "format": "google-datetime", "description": "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.", "type": "string" }, "deploymentGroup": { "type": "string", "description": "Name of a deployment group in an environment bound to the environment group in the following format: `organizations/{org}/environment/{env}/deploymentGroups/{group}` Only one of environment or deployment_group will be set." }, "environment": { "description": "Name of an environment bound to the environment group in the following format: `organizations/{org}/environments/{env}`. Only one of environment or deployment_group will be set.", "type": "string" }, "basepath": { "description": "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.", "type": "string" } } }, "GoogleCloudApigeeV1AsyncQuery": { "type": "object", "id": "GoogleCloudApigeeV1AsyncQuery", "properties": { "self": { "description": "Self link of the query. Example: `/organizations/myorg/environments/myenv/queries/9cfc0d85-0f30-46d6-ae6f-318d0cb961bd` or following format if query is running at host level: `/organizations/myorg/hostQueries/9cfc0d85-0f30-46d6-ae6f-318d0cb961bd`", "type": "string" }, "queryParams": { "description": "Contains information like metrics, dimenstions etc of the AsyncQuery.", "$ref": "GoogleCloudApigeeV1QueryMetadata" }, "resultFileSize": { "type": "string", "description": "ResultFileSize is available only after the query is completed." }, "resultRows": { "format": "int64", "description": "ResultRows is available only after the query is completed.", "type": "string" }, "state": { "type": "string", "description": "Query state could be \"enqueued\", \"running\", \"completed\", \"failed\"." }, "envgroupHostname": { "description": "Hostname is available only when query is executed at host level.", "type": "string" }, "executionTime": { "type": "string", "description": "ExecutionTime is available only after the query is completed." }, "reportDefinitionId": { "type": "string", "description": "Asynchronous Report ID." }, "result": { "description": "Result is available only after the query is completed.", "$ref": "GoogleCloudApigeeV1AsyncQueryResult" }, "name": { "type": "string", "description": "Asynchronous Query Name." }, "updated": { "type": "string", "description": "Last updated timestamp for the query." }, "error": { "type": "string", "description": "Error is set when query fails." }, "created": { "description": "Creation time of the query.", "type": "string" } } }, "GoogleCloudApigeeV1NodeConfig": { "id": "GoogleCloudApigeeV1NodeConfig", "properties": { "minNodeCount": { "description": "Optional. The minimum total number of gateway nodes that the is reserved for all instances that has the specified environment. If not specified, the default is determined by the recommended minimum number of nodes for that gateway.", "type": "string", "format": "int64" }, "currentAggregateNodeCount": { "readOnly": true, "description": "Output only. The current total number of gateway nodes that each environment currently has across all instances.", "format": "int64", "type": "string" }, "maxNodeCount": { "format": "int64", "type": "string", "description": "Optional. The maximum total number of gateway nodes that the is reserved for all instances that has the specified environment. If not specified, the default is determined by the recommended maximum number of nodes for that gateway." } }, "description": "NodeConfig for setting the min/max number of nodes associated with the environment.", "type": "object" }, "GoogleCloudApigeeV1KeystoreConfig": { "properties": { "aliases": { "description": "Aliases in the keystore.", "items": { "$ref": "GoogleCloudApigeeV1AliasRevisionConfig" }, "type": "array" }, "name": { "type": "string", "description": "Resource name in the following format: `organizations/{org}/environments/{env}/keystores/{keystore}`" } }, "type": "object", "id": "GoogleCloudApigeeV1KeystoreConfig" }, "GoogleCloudApigeeV1UpdateError": { "description": "Details on why a resource update failed in the runtime.", "id": "GoogleCloudApigeeV1UpdateError", "properties": { "resource": { "type": "string", "description": "The sub resource specific to this error (e.g. a proxy deployed within the EnvironmentConfig). If empty the error refers to the top level resource." }, "message": { "description": "User-friendly error message.", "type": "string" }, "code": { "type": "string", "enumDescriptions": [ "Not an error; returned on success. HTTP Mapping: 200 OK", "The operation was cancelled, typically by the caller. HTTP Mapping: 499 Client Closed Request", "Unknown error. For example, this error may be returned when a `Status` value received from another address space belongs to an error space that is not known in this address space. Also errors raised by APIs that do not return enough error information may be converted to this error. HTTP Mapping: 500 Internal Server Error", "The client specified an invalid argument. Note that this differs from `FAILED_PRECONDITION`. `INVALID_ARGUMENT` indicates arguments that are problematic regardless of the state of the system (e.g., a malformed file name). HTTP Mapping: 400 Bad Request", "The deadline expired before the operation could complete. For operations that change the state of the system, this error may be returned even if the operation has completed successfully. For example, a successful response from a server could have been delayed long enough for the deadline to expire. HTTP Mapping: 504 Gateway Timeout", "Some requested entity (e.g., file or directory) was not found. Note to server developers: if a request is denied for an entire class of users, such as gradual feature rollout or undocumented allowlist, `NOT_FOUND` may be used. If a request is denied for some users within a class of users, such as user-based access control, `PERMISSION_DENIED` must be used. HTTP Mapping: 404 Not Found", "The entity that a client attempted to create (e.g., file or directory) already exists. HTTP Mapping: 409 Conflict", "The caller does not have permission to execute the specified operation. `PERMISSION_DENIED` must not be used for rejections caused by exhausting some resource (use `RESOURCE_EXHAUSTED` instead for those errors). `PERMISSION_DENIED` must not be used if the caller can not be identified (use `UNAUTHENTICATED` instead for those errors). This error code does not imply the request is valid or the requested entity exists or satisfies other pre-conditions. HTTP Mapping: 403 Forbidden", "The request does not have valid authentication credentials for the operation. HTTP Mapping: 401 Unauthorized", "Some resource has been exhausted, perhaps a per-user quota, or perhaps the entire file system is out of space. HTTP Mapping: 429 Too Many Requests", "The operation was rejected because the system is not in a state required for the operation's execution. For example, the directory to be deleted is non-empty, an rmdir operation is applied to a non-directory, etc. Service implementors can use the following guidelines to decide between `FAILED_PRECONDITION`, `ABORTED`, and `UNAVAILABLE`: (a) Use `UNAVAILABLE` if the client can retry just the failing call. (b) Use `ABORTED` if the client should retry at a higher level. For example, when a client-specified test-and-set fails, indicating the client should restart a read-modify-write sequence. (c) Use `FAILED_PRECONDITION` if the client should not retry until the system state has been explicitly fixed. For example, if an \"rmdir\" fails because the directory is non-empty, `FAILED_PRECONDITION` should be returned since the client should not retry unless the files are deleted from the directory. HTTP Mapping: 400 Bad Request", "The operation was aborted, typically due to a concurrency issue such as a sequencer check failure or transaction abort. See the guidelines above for deciding between `FAILED_PRECONDITION`, `ABORTED`, and `UNAVAILABLE`. HTTP Mapping: 409 Conflict", "The operation was attempted past the valid range. E.g., seeking or reading past end-of-file. Unlike `INVALID_ARGUMENT`, this error indicates a problem that may be fixed if the system state changes. For example, a 32-bit file system will generate `INVALID_ARGUMENT` if asked to read at an offset that is not in the range [0,2^32-1], but it will generate `OUT_OF_RANGE` if asked to read from an offset past the current file size. There is a fair bit of overlap between `FAILED_PRECONDITION` and `OUT_OF_RANGE`. We recommend using `OUT_OF_RANGE` (the more specific error) when it applies so that callers who are iterating through a space can easily look for an `OUT_OF_RANGE` error to detect when they are done. HTTP Mapping: 400 Bad Request", "The operation is not implemented or is not supported/enabled in this service. HTTP Mapping: 501 Not Implemented", "Internal errors. This means that some invariants expected by the underlying system have been broken. This error code is reserved for serious errors. HTTP Mapping: 500 Internal Server Error", "The service is currently unavailable. This is most likely a transient condition, which can be corrected by retrying with a backoff. Note that it is not always safe to retry non-idempotent operations. See the guidelines above for deciding between `FAILED_PRECONDITION`, `ABORTED`, and `UNAVAILABLE`. HTTP Mapping: 503 Service Unavailable", "Unrecoverable data loss or corruption. HTTP Mapping: 500 Internal Server Error" ], "description": "Status code.", "enum": [ "OK", "CANCELLED", "UNKNOWN", "INVALID_ARGUMENT", "DEADLINE_EXCEEDED", "NOT_FOUND", "ALREADY_EXISTS", "PERMISSION_DENIED", "UNAUTHENTICATED", "RESOURCE_EXHAUSTED", "FAILED_PRECONDITION", "ABORTED", "OUT_OF_RANGE", "UNIMPLEMENTED", "INTERNAL", "UNAVAILABLE", "DATA_LOSS" ] }, "type": { "type": "string", "description": "A string that uniquely identifies the type of error. This provides a more reliable means to deduplicate errors across revisions and instances." } }, "type": "object" }, "GoogleCloudApigeeV1OptimizedStatsNode": { "description": "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.", "properties": { "data": { "items": { "type": "any" }, "type": "array" } }, "type": "object", "id": "GoogleCloudApigeeV1OptimizedStatsNode" }, "GoogleCloudApigeeV1App": { "id": "GoogleCloudApigeeV1App", "type": "object", "properties": { "keyExpiresIn": { "type": "string", "format": "int64", "description": "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" }, "developerId": { "type": "string", "description": "ID of the developer." }, "developerEmail": { "type": "string", "description": "Email of the developer." }, "companyName": { "type": "string", "description": "Name of the company that owns the app." }, "callbackUrl": { "description": "Callback URL used by OAuth 2.0 authorization servers to communicate authorization codes back to apps.", "type": "string" }, "name": { "type": "string", "description": "Name of the app." }, "appId": { "type": "string", "description": "ID of the app." }, "apiProducts": { "items": { "$ref": "GoogleCloudApigeeV1ApiProductRef" }, "type": "array", "description": "List of API products associated with the app." }, "attributes": { "items": { "$ref": "GoogleCloudApigeeV1Attribute" }, "description": "List of attributes.", "type": "array" }, "lastModifiedAt": { "format": "int64", "description": "Output only. Last modified time as milliseconds since epoch.", "readOnly": true, "type": "string" }, "appGroup": { "type": "string", "description": "Name of the AppGroup" }, "credentials": { "type": "array", "description": "Output only. Set of credentials for the app. Credentials are API key/secret pairs associated with API products.", "items": { "$ref": "GoogleCloudApigeeV1Credential" }, "readOnly": true }, "createdAt": { "description": "Output only. Unix time when the app was created.", "type": "string", "readOnly": true, "format": "int64" }, "status": { "type": "string", "description": "Status of the credential." }, "scopes": { "type": "array", "items": { "type": "string" }, "description": "Scopes to apply to the app. The specified scope names must already exist on the API product that you associate with the app." } } }, "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsResponse": { "description": "Response for BatchComputeSecurityAssessmentResults.", "type": "object", "properties": { "nextPageToken": { "type": "string", "description": "A token that can be sent as `page_token` to retrieve the next page. If this field is blank, there are no subsequent pages." }, "securityAssessmentResults": { "items": { "$ref": "GoogleCloudApigeeV1SecurityAssessmentResult" }, "description": "Default sort order is by resource name in alphabetic order.", "type": "array" }, "assessmentTime": { "format": "google-datetime", "type": "string", "description": "The time of the assessment api call." } }, "id": "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsResponse" }, "GoogleCloudApigeeV1ExpireDeveloperSubscriptionRequest": { "id": "GoogleCloudApigeeV1ExpireDeveloperSubscriptionRequest", "type": "object", "description": "Request for ExpireDeveloperSubscription.", "properties": {} }, "GoogleCloudApigeeV1RuntimeTraceConfig": { "description": "NEXT ID: 8 RuntimeTraceConfig defines the configurations for distributed trace in an environment.", "properties": { "overrides": { "items": { "$ref": "GoogleCloudApigeeV1RuntimeTraceConfigOverride" }, "description": "List of trace configuration overrides for spicific API proxies.", "type": "array" }, "samplingConfig": { "$ref": "GoogleCloudApigeeV1RuntimeTraceSamplingConfig", "description": "Trace configuration for all API proxies in an environment." }, "endpoint": { "type": "string", "description": "Endpoint of the exporter." }, "name": { "description": "Name of the trace config in the following format: `organizations/{org}/environment/{env}/traceConfig`", "type": "string" }, "revisionId": { "type": "string", "description": "Revision number which can be used by the runtime to detect if the trace config has changed between two versions." }, "exporter": { "enumDescriptions": [ "Exporter unspecified", "Jaeger exporter", "Cloudtrace exporter" ], "description": "Exporter that is used to view the distributed trace captured using OpenCensus. An exporter sends traces to any backend that is capable of consuming them. Recorded spans can be exported by registered exporters.", "type": "string", "enum": [ "EXPORTER_UNSPECIFIED", "JAEGER", "CLOUD_TRACE" ] }, "revisionCreateTime": { "description": "The timestamp that the revision was created or updated.", "format": "google-datetime", "type": "string" } }, "type": "object", "id": "GoogleCloudApigeeV1RuntimeTraceConfig" }, "GoogleIamV1TestIamPermissionsRequest": { "id": "GoogleIamV1TestIamPermissionsRequest", "properties": { "permissions": { "type": "array", "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or `storage.*`) are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", "items": { "type": "string" } } }, "description": "Request message for `TestIamPermissions` method.", "type": "object" }, "GoogleCloudApigeeV1AppGroupApp": { "type": "object", "description": "Response for [GetAppGroupApp].[AppGroupApps.GetAppGroupApp], [CreateAppGroupAppRequest].[AppGroupApp.CreateAppGroupAppRequest] and [DeleteAppGroupApp].[AppGroupApp.DeleteAppGroupApp]", "id": "GoogleCloudApigeeV1AppGroupApp", "properties": { "attributes": { "description": "List of attributes for the AppGroup app.", "items": { "$ref": "GoogleCloudApigeeV1Attribute" }, "type": "array" }, "appGroup": { "description": "Immutable. Name of the parent AppGroup whose resource name format is of syntax (organizations/*/appgroups/*).", "type": "string" }, "name": { "description": "Immutable. Name of the AppGroup app whose resource name format is of syntax (organizations/*/appgroups/*/apps/*).", "type": "string" }, "lastModifiedAt": { "readOnly": true, "format": "int64", "description": "Output only. Time the AppGroup app was modified in milliseconds since epoch.", "type": "string" }, "status": { "type": "string", "description": "Status of the App. Valid values include `approved` or `revoked`." }, "appId": { "type": "string", "description": "Immutable. ID of the AppGroup app." }, "credentials": { "description": "Output only. Set of credentials for the AppGroup app consisting of the consumer key/secret pairs associated with the API products.", "readOnly": true, "type": "array", "items": { "$ref": "GoogleCloudApigeeV1Credential" } }, "apiProducts": { "type": "array", "description": "List of API products associated with the AppGroup app.", "items": { "type": "string" } }, "createdAt": { "type": "string", "format": "int64", "readOnly": true, "description": "Output only. Time the AppGroup app was created in milliseconds since epoch." }, "callbackUrl": { "description": "Callback URL used by OAuth 2.0 authorization servers to communicate authorization codes back to AppGroup apps.", "type": "string" }, "scopes": { "items": { "type": "string" }, "description": "Scopes to apply to the AppGroup app. The specified scopes must already exist for the API product that you associate with the AppGroup app.", "type": "array" }, "keyExpiresIn": { "description": "Immutable. Expiration time, in seconds, for the consumer key that is generated for the AppGroup 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.", "format": "int64", "type": "string" } } }, "GoogleCloudApigeeV1DeploymentChangeReportRoutingChange": { "type": "object", "id": "GoogleCloudApigeeV1DeploymentChangeReportRoutingChange", "properties": { "description": { "type": "string", "description": "Human-readable description of this routing change." }, "toDeployment": { "description": "Base path/deployment that may start receiving that traffic. May be null if no deployment is able to receive the traffic.", "$ref": "GoogleCloudApigeeV1DeploymentChangeReportRoutingDeployment" }, "shouldSequenceRollout": { "type": "boolean", "description": "Set to `true` if using sequenced rollout would make this routing change safer. **Note**: This does not necessarily imply that automated sequenced rollout mode is supported for the operation." }, "environmentGroup": { "type": "string", "description": "Name of the environment group affected by this routing change." }, "fromDeployment": { "description": "Base path/deployment that may stop receiving some traffic.", "$ref": "GoogleCloudApigeeV1DeploymentChangeReportRoutingDeployment" } }, "description": "Describes a potential routing change that may occur as a result of some deployment operation." }, "GoogleCloudApigeeV1CanaryEvaluationMetricLabels": { "type": "object", "properties": { "instance_id": { "type": "string", "description": "Required. The instance ID associated with the metrics. In Apigee Hybrid, the value is configured during installation." }, "location": { "type": "string", "description": "Required. The location associated with the metrics." }, "env": { "type": "string", "description": "The environment ID associated with the metrics." } }, "id": "GoogleCloudApigeeV1CanaryEvaluationMetricLabels", "description": "Labels that can be used to filter Apigee metrics." }, "GoogleCloudApigeeV1SecurityProfileEnvironmentAssociation": { "type": "object", "id": "GoogleCloudApigeeV1SecurityProfileEnvironmentAssociation", "description": "Represents a SecurityProfileEnvironmentAssociation resource.", "properties": { "name": { "description": "Immutable. Name of the environment that the profile is attached to.", "type": "string" }, "attachTime": { "description": "Output only. The time when environment was attached to the security profile.", "readOnly": true, "format": "google-datetime", "type": "string" }, "securityProfileRevisionId": { "description": "DEPRECATED: DO NOT USE Revision ID of the security profile.", "format": "int64", "type": "string", "deprecated": true } } }, "GoogleCloudApigeeV1ResourceStatus": { "description": "The status of a resource loaded in the runtime.", "id": "GoogleCloudApigeeV1ResourceStatus", "properties": { "resource": { "description": "The resource name. Currently only two resources are supported: EnvironmentGroup - organizations/{org}/envgroups/{envgroup} EnvironmentConfig - organizations/{org}/environments/{environment}/deployedConfig", "type": "string" }, "revisions": { "items": { "$ref": "GoogleCloudApigeeV1RevisionStatus" }, "type": "array", "description": "Revisions of the resource currently deployed in the instance." }, "totalReplicas": { "description": "The total number of replicas that should have this resource.", "type": "integer", "format": "int32" }, "uid": { "description": "The uid of the resource. In the unexpected case that the instance has multiple uids for the same name, they should be reported under separate ResourceStatuses.", "type": "string" } }, "type": "object" }, "GoogleCloudApigeeV1ListAsyncQueriesResponse": { "type": "object", "id": "GoogleCloudApigeeV1ListAsyncQueriesResponse", "description": "The response for ListAsyncQueries.", "properties": { "queries": { "items": { "$ref": "GoogleCloudApigeeV1AsyncQuery" }, "type": "array", "description": "The asynchronous queries belong to requested resource name." } } }, "GoogleCloudApigeeV1ComputeEnvironmentScoresRequestFilter": { "id": "GoogleCloudApigeeV1ComputeEnvironmentScoresRequestFilter", "type": "object", "description": "Filter scores by component path. Used custom filter instead of AIP-160 as the use cases are highly constrained and predictable.", "properties": { "scorePath": { "type": "string", "description": "Optional. Return scores for this component. Example: \"/org@myorg/envgroup@myenvgroup/env@myenv/proxies/proxy@myproxy/source\"" } } }, "GoogleCloudApigeeV1Alias": { "type": "object", "id": "GoogleCloudApigeeV1Alias", "properties": { "certsInfo": { "description": "Chain of certificates under this alias.", "$ref": "GoogleCloudApigeeV1Certificate" }, "type": { "type": "string", "description": "Type of alias.", "enum": [ "ALIAS_TYPE_UNSPECIFIED", "CERT", "KEY_CERT" ], "enumDescriptions": [ "Alias type is not specified.", "Certificate.", "Key/certificate pair." ] }, "alias": { "type": "string", "description": "Resource ID for this alias. Values must match the regular expression `[^/]{1,255}`." } }, "description": "Reference to a certificate or key/certificate pair." }, "GoogleCloudApigeeV1InstanceDeploymentStatus": { "properties": { "instance": { "type": "string", "description": "ID of the instance reporting the status." }, "deployedRoutes": { "type": "array", "items": { "$ref": "GoogleCloudApigeeV1InstanceDeploymentStatusDeployedRoute" }, "description": "Current routes deployed in the ingress routing table. A route which is missing will appear in `missing_routes`." }, "deployedRevisions": { "items": { "$ref": "GoogleCloudApigeeV1InstanceDeploymentStatusDeployedRevision" }, "type": "array", "description": "Revisions currently deployed in MPs." } }, "description": "The status of a deployment as reported by a single instance.", "id": "GoogleCloudApigeeV1InstanceDeploymentStatus", "type": "object" }, "GoogleCloudApigeeV1DisableSecurityActionRequest": { "properties": {}, "description": "Message to disable an enabled SecurityAction.", "id": "GoogleCloudApigeeV1DisableSecurityActionRequest", "type": "object" }, "GoogleCloudApigeeV1ApiProxyRevision": { "properties": { "proxyEndpoints": { "type": "array", "items": { "type": "string" }, "description": "List of ProxyEndpoints in the `/proxies` directory of the API proxy. Typically, this element is included only when the API proxy was created using the Edge UI. This is a 'manifest' setting designed to provide visibility into the contents of the API proxy." }, "contextInfo": { "type": "string", "description": "Revision number, app name, and organization for the API proxy." }, "lastModifiedAt": { "format": "int64", "description": "Time that the API proxy revision was last modified in milliseconds since epoch.", "type": "string" }, "spec": { "type": "string", "description": "OpenAPI Specification that is associated with the API proxy. The value is set to a URL or to a path in the specification store." }, "configurationVersion": { "$ref": "GoogleCloudApigeeV1ConfigVersion", "description": "Version of the API proxy configuration schema to which the API proxy conforms. Currently, the only supported value is 4.0 (`majorVersion.minorVersion`). This setting may be used in the future to track the evolution of the API proxy format." }, "description": { "type": "string", "description": "Description of the API proxy revision." }, "policies": { "description": "List of policy names included in the API proxy revision..", "items": { "type": "string" }, "type": "array" }, "targetEndpoints": { "items": { "type": "string" }, "description": "List of TargetEndpoints in the `/targets` directory of the API proxy. Typically, this element is included only when the API proxy was created using the Edge UI. This is a 'manifest' setting designed to provide visibility into the contents of the API proxy.", "type": "array" }, "resourceFiles": { "description": "List of resource files included in the API proxy revision.", "$ref": "GoogleCloudApigeeV1ResourceFiles" }, "resources": { "type": "array", "items": { "type": "string" }, "description": "List of the resources included in the API proxy revision formatted as \"{type}://{name}\"." }, "integrationEndpoints": { "description": "List of IntegrationEndpoints in the '/integration-endpoints' directory of the API proxy. This is a 'manifest' setting designed to provide visibility into the contents of the API proxy.", "items": { "type": "string" }, "type": "array" }, "targets": { "type": "array", "description": "List of the targets included in the API proxy revision.", "items": { "type": "string" } }, "targetServers": { "type": "array", "description": "List of TargetServers referenced in any TargetEndpoint in the API proxy. Typically, you will see this element only when the API proxy was created using the Edge UI. This is a 'manifest' setting designed to provide visibility into the contents of the API proxy.", "items": { "type": "string" } }, "revision": { "type": "string", "description": "API proxy revision." }, "name": { "type": "string", "description": "Name of the API proxy." }, "hasExtensiblePolicy": { "description": "Output only. This field will be marked as true if revision contains any policies marked as extensible.", "readOnly": true, "type": "boolean" }, "displayName": { "description": "Human-readable name of the API proxy.", "type": "string" }, "createdAt": { "description": "Time that the API proxy revision was created in milliseconds since epoch.", "format": "int64", "type": "string" }, "teams": { "items": { "type": "string" }, "type": "array", "description": "List of the teams included in the API proxy revision." }, "entityMetaDataAsProperties": { "type": "object", "description": "Metadata describing the API proxy revision as a key-value map.", "additionalProperties": { "type": "string" } }, "sharedFlows": { "items": { "type": "string" }, "type": "array", "description": "List of the shared flows included in the API proxy revision." }, "archive": { "readOnly": true, "type": "string", "description": "Output only. The archive that generated this proxy revision. This field is only present on proxy revisions that were generated by an archive. Proxies generated by archives cannot be updated, deleted, or deployed to other environments. Format: `organizations/*/environments/*/archiveDeployments/*`" }, "proxies": { "description": "List of proxy names included in the API proxy revision.", "type": "array", "items": { "type": "string" } }, "type": { "type": "string", "description": "Type. Set to `Application`. Maintained for compatibility with the Apigee Edge API." }, "basepaths": { "type": "array", "description": "Base URL of the API proxy.", "items": { "type": "string" } } }, "type": "object", "description": "API proxy revision.", "id": "GoogleCloudApigeeV1ApiProxyRevision" }, "GoogleCloudApigeeV1Subscription": { "description": "Pub/Sub subscription of an environment.", "properties": { "name": { "description": "Full name of the Pub/Sub subcription. Use the following structure in your request: `subscription \"projects/foo/subscription/bar\"`", "type": "string" } }, "id": "GoogleCloudApigeeV1Subscription", "type": "object" }, "GoogleCloudApigeeV1ListOfDevelopersResponse": { "id": "GoogleCloudApigeeV1ListOfDevelopersResponse", "properties": { "developer": { "items": { "$ref": "GoogleCloudApigeeV1Developer" }, "type": "array", "description": "List of developers." } }, "type": "object" }, "GoogleCloudApigeeV1IntegrationConfig": { "properties": { "enabled": { "description": "Flag that specifies whether the Integration add-on is enabled.", "type": "boolean" } }, "description": "Configuration for the Integration add-on.", "id": "GoogleCloudApigeeV1IntegrationConfig", "type": "object" }, "GoogleCloudApigeeV1OperationMetadata": { "id": "GoogleCloudApigeeV1OperationMetadata", "properties": { "progress": { "$ref": "GoogleCloudApigeeV1OperationMetadataProgress", "description": "Progress of the operation." }, "targetResourceName": { "description": "Name of the resource for which the operation is operating on.", "type": "string" }, "operationType": { "type": "string", "enum": [ "OPERATION_TYPE_UNSPECIFIED", "INSERT", "DELETE", "UPDATE" ], "enumDescriptions": [ "", "", "", "" ] }, "state": { "enum": [ "STATE_UNSPECIFIED", "NOT_STARTED", "IN_PROGRESS", "FINISHED" ], "type": "string", "enumDescriptions": [ "", "", "", "" ] }, "warnings": { "type": "array", "items": { "type": "string" }, "description": "Warnings encountered while executing the operation." } }, "description": "Metadata describing an Operation.", "type": "object" }, "GoogleCloudApigeeV1FlowHook": { "properties": { "continueOnError": { "type": "boolean", "description": "Optional. Flag that specifies whether execution should continue if the flow hook throws an exception. Set to `true` to continue execution. Set to `false` to stop execution if the flow hook throws an exception. Defaults to `true`." }, "description": { "type": "string", "description": "Description of the flow hook." }, "sharedFlow": { "type": "string", "description": "Shared flow attached to this flow hook, or empty if there is none attached." }, "flowHookPoint": { "readOnly": true, "description": "Output only. Where in the API call flow the flow hook is invoked. Must be one of `PreProxyFlowHook`, `PostProxyFlowHook`, `PreTargetFlowHook`, or `PostTargetFlowHook`.", "type": "string" } }, "id": "GoogleCloudApigeeV1FlowHook", "type": "object" }, "GoogleCloudApigeeV1ApiSecurityRuntimeConfig": { "type": "object", "properties": { "location": { "type": "array", "description": "A list of up to 5 Cloud Storage Blobs that contain SecurityActions.", "items": { "type": "string" } }, "revisionId": { "format": "int64", "type": "string", "description": "Revision ID of the API Security Runtime configuration. The higher the value, the more recently the configuration was deployed." }, "updateTime": { "format": "google-datetime", "description": "Time that the API Security Runtime configuration was updated.", "type": "string" }, "uid": { "type": "string", "description": "Unique ID for the API Security Runtime configuration. The ID will only change if the environment is deleted and recreated." }, "name": { "description": "Name of the environment API Security Runtime configuration resource. Format: `organizations/{org}/environments/{env}/apiSecurityRuntimeConfig`", "type": "string" } }, "id": "GoogleCloudApigeeV1ApiSecurityRuntimeConfig", "description": "Response for GetApiSecurityRuntimeConfig[EnvironmentService.GetApiSecurityRuntimeConfig]." }, "GoogleCloudApigeeV1RuntimeApiSecurityConfig": { "description": "Runtime configuration for the API Security add-on.", "id": "GoogleCloudApigeeV1RuntimeApiSecurityConfig", "properties": { "enabled": { "description": "If the API Security is enabled or not.", "type": "boolean" } }, "type": "object" }, "GoogleCloudApigeeV1TlsInfoCommonName": { "id": "GoogleCloudApigeeV1TlsInfoCommonName", "type": "object", "properties": { "wildcardMatch": { "description": "Indicates whether the cert should be matched against as a wildcard cert.", "type": "boolean" }, "value": { "type": "string", "description": "The TLS Common Name string of the certificate." } } }, "GoogleCloudApigeeV1Point": { "type": "object", "description": "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.", "properties": { "results": { "type": "array", "description": "List of results extracted from a given debug point.", "items": { "$ref": "GoogleCloudApigeeV1Result" } }, "id": { "type": "string", "description": "Name of a step in the transaction." } }, "id": "GoogleCloudApigeeV1Point" }, "GoogleCloudApigeeV1ListTraceConfigOverridesResponse": { "id": "GoogleCloudApigeeV1ListTraceConfigOverridesResponse", "properties": { "traceConfigOverrides": { "items": { "$ref": "GoogleCloudApigeeV1TraceConfigOverride" }, "description": "List all trace configuration overrides in an environment.", "type": "array" }, "nextPageToken": { "type": "string", "description": "Token value that can be passed as `page_token` to retrieve the next page of content." } }, "type": "object", "description": "Response for ListTraceConfigOverrides." }, "GoogleCloudApigeeV1SecurityActionDeny": { "id": "GoogleCloudApigeeV1SecurityActionDeny", "properties": { "responseCode": { "format": "int32", "type": "integer", "description": "Optional. The HTTP response code if the Action = DENY." } }, "type": "object", "description": "Message that should be set in case of a Deny Action." }, "GoogleCloudApigeeV1ReportProperty": { "type": "object", "id": "GoogleCloudApigeeV1ReportProperty", "properties": { "value": { "items": { "$ref": "GoogleCloudApigeeV1Attribute" }, "description": "property values", "type": "array" }, "property": { "type": "string", "description": "name of the property" } } }, "GoogleCloudApigeeV1ListDebugSessionsResponse": { "id": "GoogleCloudApigeeV1ListDebugSessionsResponse", "properties": { "sessions": { "description": "Session info that includes debug session ID and the first transaction creation timestamp.", "items": { "$ref": "GoogleCloudApigeeV1Session" }, "type": "array" }, "nextPageToken": { "type": "string", "description": "Page token that you can include in a ListDebugSessionsRequest to retrieve the next page. If omitted, no subsequent pages exist." } }, "type": "object" }, "GoogleCloudApigeeV1ListAppsResponse": { "type": "object", "properties": { "totalSize": { "format": "int32", "type": "integer", "description": "Total count of Apps." }, "app": { "items": { "$ref": "GoogleCloudApigeeV1App" }, "type": "array" }, "nextPageToken": { "description": "Token that can be sent as `next_page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } }, "id": "GoogleCloudApigeeV1ListAppsResponse" }, "GoogleCloudApigeeV1NatAddress": { "properties": { "state": { "type": "string", "description": "Output only. State of the nat address.", "enum": [ "STATE_UNSPECIFIED", "CREATING", "RESERVED", "ACTIVE", "DELETING" ], "readOnly": true, "enumDescriptions": [ "The resource is in an unspecified state.", "The NAT address is being created.", "The NAT address is reserved but not yet used for Internet egress.", "The NAT address is active and used for Internet egress.", "The NAT address is being deleted." ] }, "name": { "type": "string", "description": "Required. Resource ID of the NAT address." }, "ipAddress": { "readOnly": true, "description": "Output only. The static IPV4 address.", "type": "string" } }, "description": "Apigee NAT(network address translation) address. A NAT address is a static external IP address used for Internet egress traffic.", "id": "GoogleCloudApigeeV1NatAddress", "type": "object" }, "GoogleCloudApigeeV1CanaryEvaluation": { "id": "GoogleCloudApigeeV1CanaryEvaluation", "properties": { "treatment": { "type": "string", "description": "Required. The newer version that is serving requests." }, "createTime": { "readOnly": true, "format": "google-datetime", "type": "string", "description": "Output only. Create time of the canary evaluation." }, "verdict": { "enumDescriptions": [ "Verdict is not available yet.", "No verdict reached.", "Evaluation is not good.", "Evaluation is good." ], "enum": [ "VERDICT_UNSPECIFIED", "NONE", "FAIL", "PASS" ], "type": "string", "description": "Output only. The resulting verdict of the canary evaluations: NONE, PASS, or FAIL.", "readOnly": true }, "control": { "type": "string", "description": "Required. The stable version that is serving requests." }, "endTime": { "description": "Required. End time for the evaluation's analysis.", "type": "string", "format": "google-datetime" }, "startTime": { "description": "Required. Start time for the canary evaluation's analysis.", "type": "string", "format": "google-datetime" }, "state": { "enum": [ "STATE_UNSPECIFIED", "RUNNING", "SUCCEEDED" ], "readOnly": true, "description": "Output only. The current state of the canary evaluation.", "type": "string", "enumDescriptions": [ "No state has been specified.", "The canary evaluation is still in progress.", "The canary evaluation has finished." ] }, "name": { "type": "string", "description": "Output only. Name of the canary evalution.", "readOnly": true }, "metricLabels": { "$ref": "GoogleCloudApigeeV1CanaryEvaluationMetricLabels", "description": "Required. Labels used to filter the metrics used for a canary evaluation." } }, "type": "object", "description": "CanaryEvaluation represents the canary analysis between two versions of the runtime that is serving requests." }, "GoogleCloudApigeeV1DeleteResponse": { "type": "object", "properties": { "gcpResource": { "type": "string", "description": "Google Cloud name of deleted resource." }, "status": { "description": "Status of the operation.", "type": "string" }, "message": { "type": "string", "description": "Description of the operation." }, "errorCode": { "type": "string", "description": "Unique error code for the request, if any." }, "requestId": { "type": "string", "description": "Unique ID of the request." } }, "id": "GoogleCloudApigeeV1DeleteResponse", "description": "Response for certain delete operations." }, "GoogleCloudApigeeV1ListExportsResponse": { "type": "object", "id": "GoogleCloudApigeeV1ListExportsResponse", "description": "The response for ListExports", "properties": { "exports": { "items": { "$ref": "GoogleCloudApigeeV1Export" }, "description": "Details of the export jobs.", "type": "array" } } }, "GoogleCloudApigeeV1GenerateDownloadUrlRequest": { "type": "object", "properties": {}, "id": "GoogleCloudApigeeV1GenerateDownloadUrlRequest", "description": "Request for GenerateDownloadUrl method." }, "GoogleCloudApigeeV1GraphQLOperationConfig": { "type": "object", "id": "GoogleCloudApigeeV1GraphQLOperationConfig", "properties": { "operations": { "items": { "$ref": "GoogleCloudApigeeV1GraphQLOperation" }, "description": "Required. List of GraphQL name/operation type pairs for the proxy or remote service to which quota will be applied. If only operation types are specified, the quota will be applied to all GraphQL requests irrespective of the GraphQL name. **Note**: Currently, you can specify only a single GraphQLOperation. Specifying more than one will cause the operation to fail.", "type": "array" }, "attributes": { "type": "array", "description": "Custom attributes associated with the operation.", "items": { "$ref": "GoogleCloudApigeeV1Attribute" } }, "quota": { "description": "Quota parameters to be enforced for the resources, methods, and API source combination. If none are specified, quota enforcement will not be done.", "$ref": "GoogleCloudApigeeV1Quota" }, "apiSource": { "description": "Required. Name of the API proxy endpoint or remote service with which the GraphQL operation and quota are associated.", "type": "string" } }, "description": "Binds the resources in a proxy or remote service with the GraphQL operation and its associated quota enforcement." }, "GoogleCloudApigeeV1Developer": { "id": "GoogleCloudApigeeV1Developer", "properties": { "attributes": { "items": { "$ref": "GoogleCloudApigeeV1Attribute" }, "description": "Optional. Developer attributes (name/value pairs). The custom attribute limit is 18.", "type": "array" }, "lastModifiedAt": { "readOnly": true, "description": "Output only. Time at which the developer was last modified in milliseconds since epoch.", "format": "int64", "type": "string" }, "companies": { "items": { "type": "string" }, "description": "List of companies associated with the developer.", "type": "array" }, "status": { "description": "Output only. Status of the developer. Valid values are `active` and `inactive`.", "type": "string", "readOnly": true }, "developerId": { "description": "ID of the developer. **Note**: IDs are generated internally by Apigee and are not guaranteed to stay the same over time.", "type": "string" }, "appFamily": { "description": "Developer app family.", "type": "string" }, "userName": { "description": "Required. User name of the developer. Not used by Apigee hybrid.", "type": "string" }, "apps": { "items": { "type": "string" }, "type": "array", "description": "List of apps associated with the developer." }, "email": { "description": "Required. Email address of the developer. This value is used to uniquely identify the developer in Apigee hybrid. Note that the email address has to be in lowercase only.", "type": "string" }, "organizationName": { "readOnly": true, "description": "Output only. Name of the Apigee organization in which the developer resides.", "type": "string" }, "lastName": { "description": "Required. Last name of the developer.", "type": "string" }, "firstName": { "type": "string", "description": "Required. First name of the developer." }, "createdAt": { "format": "int64", "type": "string", "description": "Output only. Time at which the developer was created in milliseconds since epoch.", "readOnly": true }, "accessType": { "type": "string", "description": "Access type." } }, "type": "object" }, "GoogleCloudApigeeV1AccessLoggingConfig": { "properties": { "filter": { "type": "string", "description": "Optional. Ship the access log entries that match the status_code defined in the filter. The status_code is the only expected/supported filter field. (Ex: status_code) The filter will parse it to the Common Expression Language semantics for expression evaluation to build the filter condition. (Ex: \"filter\": status_code \u003e= 200 && status_code \u003c 300 )" }, "enabled": { "type": "boolean", "description": "Optional. Boolean flag that specifies whether the customer access log feature is enabled." } }, "id": "GoogleCloudApigeeV1AccessLoggingConfig", "type": "object", "description": "Access logging configuration enables customers to ship the access logs from the tenant projects to their own project's cloud logging. The feature is at the instance level ad disabled by default. It can be enabled during CreateInstance or UpdateInstance." }, "GoogleCloudApigeeV1PodStatus": { "type": "object", "properties": { "podStatusTime": { "description": "Time the pod status was reported in milliseconds since epoch.", "type": "string", "format": "int64" }, "deploymentStatus": { "description": "Status of the deployment. Valid values include: - `deployed`: Successful. - `error` : Failed. - `pending` : Pod has not yet reported on the deployment.", "type": "string" }, "deploymentStatusTime": { "description": "Time the deployment status was reported in milliseconds since epoch.", "format": "int64", "type": "string" }, "statusCode": { "type": "string", "description": "Code associated with the deployment status." }, "appVersion": { "type": "string", "description": "Version of the application running in the pod." }, "deploymentTime": { "description": "Time the proxy was deployed in milliseconds since epoch.", "format": "int64", "type": "string" }, "statusCodeDetails": { "description": "Human-readable message associated with the status code.", "type": "string" }, "podName": { "type": "string", "description": "Name of the pod which is reporting the status." }, "podStatus": { "description": "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.", "type": "string" } }, "id": "GoogleCloudApigeeV1PodStatus" }, "GoogleCloudApigeeV1SecurityIncident": { "id": "GoogleCloudApigeeV1SecurityIncident", "type": "object", "properties": { "observability": { "enumDescriptions": [ "The incident observability is unspecified.", "The incident is currently active. Can change to this status from archived.", "The incident is currently archived and was archived by the customer." ], "type": "string", "description": "Optional. Indicates if the user archived this incident.", "enum": [ "OBSERVABILITY_UNSPECIFIED", "ACTIVE", "ARCHIVED" ] }, "trafficCount": { "type": "string", "format": "int64", "description": "Total traffic detected as part of the incident." }, "lastObservabilityChangeTime": { "description": "Output only. The time when the incident observability was last changed.", "readOnly": true, "format": "google-datetime", "type": "string" }, "riskLevel": { "type": "string", "enumDescriptions": [ "Risk Level Unspecified.", "Risk level of the incident is low.", "Risk level of the incident is moderate.", "Risk level of the incident is severe." ], "description": "Output only. Risk level of the incident.", "readOnly": true, "enum": [ "RISK_LEVEL_UNSPECIFIED", "LOW", "MODERATE", "SEVERE" ] }, "name": { "description": "Immutable. Name of the security incident resource. Format: organizations/{org}/environments/{environment}/securityIncidents/{incident} Example: organizations/apigee-org/environments/dev/securityIncidents/1234-5678-9101-1111", "type": "string" }, "displayName": { "description": "Optional. Display name of the security incident.", "type": "string" }, "lastDetectedTime": { "format": "google-datetime", "type": "string", "readOnly": true, "description": "Output only. The time when events associated with the incident were last detected." }, "detectionTypes": { "type": "array", "description": "Output only. Detection types which are part of the incident. Examples: Flooder, OAuth Abuser, Static Content Scraper, Anomaly Detection.", "readOnly": true, "items": { "type": "string" } }, "firstDetectedTime": { "description": "Output only. The time when events associated with the incident were first detected.", "type": "string", "readOnly": true, "format": "google-datetime" } }, "description": "Represents an SecurityIncident resource." }, "GoogleCloudApigeeV1ReportInstanceStatusRequest": { "id": "GoogleCloudApigeeV1ReportInstanceStatusRequest", "type": "object", "description": "Request for ReportInstanceStatus.", "properties": { "reportTime": { "description": "The time the report was generated in the runtime. Used to prevent an old status from overwriting a newer one. An instance should space out it's status reports so that clock skew does not play a factor.", "type": "string", "format": "google-datetime" }, "resources": { "type": "array", "items": { "$ref": "GoogleCloudApigeeV1ResourceStatus" }, "description": "Status for config resources" }, "instanceUid": { "type": "string", "description": "A unique ID for the instance which is guaranteed to be unique in case the user installs multiple hybrid runtimes with the same instance ID." } } }, "GoogleCloudApigeeV1OptimizedStats": { "type": "object", "properties": { "Response": { "description": "Wraps the `stats` response for JavaScript Optimized Scenario with a response key. For example: ```{ \"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 ] } ] } ] } } }```", "$ref": "GoogleCloudApigeeV1OptimizedStatsResponse" } }, "id": "GoogleCloudApigeeV1OptimizedStats" }, "GoogleCloudApigeeV1TlsInfoConfig": { "properties": { "trustStore": { "type": "string", "description": "Name of the keystore or keystore reference containing trusted certificates for the server in the following format: `organizations/{org}/environments/{env}/keystores/{keystore}` or `organizations/{org}/environments/{env}/references/{reference}`" }, "ignoreValidationErrors": { "description": "Flag that specifies whether to ignore TLS certificate validation errors. Set to `true` to ignore errors.", "type": "boolean" }, "enforce": { "description": "Flag that enforces TLS settings", "type": "boolean" }, "enabled": { "type": "boolean", "description": "Flag that specifies whether one-way TLS is enabled. Set to `true` to enable one-way TLS." }, "clientAuthEnabled": { "description": "Flag that specifies whether client-side authentication is enabled for the target server. Enables two-way TLS.", "type": "boolean" }, "protocols": { "type": "array", "description": "List of TLS protocols that are granted access.", "items": { "type": "string" } }, "keyAlias": { "type": "string", "description": "Name of the alias used for client-side authentication in the following format: `organizations/{org}/environments/{env}/keystores/{keystore}/aliases/{alias}`" }, "ciphers": { "type": "array", "description": "List of ciphers that are granted access.", "items": { "type": "string" } }, "keyAliasReference": { "$ref": "GoogleCloudApigeeV1KeyAliasReference", "description": "Reference name and alias pair to use for client-side authentication." }, "commonName": { "$ref": "GoogleCloudApigeeV1CommonNameConfig", "description": "Common name to validate the target server against." } }, "id": "GoogleCloudApigeeV1TlsInfoConfig", "type": "object" }, "GoogleCloudApigeeV1ListApiProductsResponse": { "id": "GoogleCloudApigeeV1ListApiProductsResponse", "type": "object", "properties": { "apiProduct": { "description": "Lists all API product names defined for an organization.", "items": { "$ref": "GoogleCloudApigeeV1ApiProduct" }, "type": "array" } } }, "GoogleCloudApigeeV1DocumentationFile": { "properties": { "displayName": { "type": "string", "description": "Required. A display name for the file, shown in the management UI. Max length is 255 characters." }, "contents": { "type": "string", "format": "byte", "description": "Required. The file contents. The max size is 4 MB." } }, "description": "Documentation file contents for a catalog item.", "id": "GoogleCloudApigeeV1DocumentationFile", "type": "object" }, "GoogleCloudApigeeV1DeveloperAppKey": { "properties": { "status": { "type": "string", "description": "Status of the credential. Valid values include `approved` or `revoked`." }, "consumerSecret": { "type": "string", "description": "Secret key." }, "expiresInSeconds": { "format": "int64", "type": "string", "description": "Input only. Expiration time, in seconds, for the consumer key. 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." }, "scopes": { "type": "array", "items": { "type": "string" }, "description": "Scopes to apply to the app. The specified scope names must already be defined for the API product that you associate with the app." }, "expiresAt": { "format": "int64", "type": "string", "description": "Time the developer app expires in milliseconds since epoch." }, "consumerKey": { "description": "Consumer key.", "type": "string" }, "issuedAt": { "format": "int64", "description": "Time the developer app was created in milliseconds since epoch.", "type": "string" }, "apiProducts": { "description": "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.", "items": { "type": "any" }, "type": "array" }, "attributes": { "type": "array", "items": { "$ref": "GoogleCloudApigeeV1Attribute" }, "description": "List of attributes associated with the credential." } }, "id": "GoogleCloudApigeeV1DeveloperAppKey", "type": "object" }, "GoogleCloudApigeeV1BatchUpdateSecurityIncidentsRequest": { "id": "GoogleCloudApigeeV1BatchUpdateSecurityIncidentsRequest", "type": "object", "properties": { "requests": { "type": "array", "description": "Optional. Required. The request message specifying the resources to update. A maximum of 1000 can be modified in a batch.", "items": { "$ref": "GoogleCloudApigeeV1UpdateSecurityIncidentRequest" } } }, "description": "Request for BatchUpdateSecurityIncident." }, "GoogleCloudApigeeV1SecuritySettings": { "id": "GoogleCloudApigeeV1SecuritySettings", "properties": { "mlRetrainingFeedbackEnabled": { "type": "boolean", "description": "Optional. If true the user consents to the use of ML models for Abuse detection." }, "name": { "type": "string", "description": "Identifier. Full resource name is always `organizations/{org}/securitySettings`." } }, "description": "SecuritySettings reflects the current state of the SecuritySettings feature.", "type": "object" }, "GoogleCloudApigeeV1SecurityActionHttpHeader": { "type": "object", "id": "GoogleCloudApigeeV1SecurityActionHttpHeader", "properties": { "name": { "description": "The header name to be sent to the target.", "type": "string" }, "value": { "description": "The header value to be sent to the target.", "type": "string" } }, "description": "An HTTP header." }, "GoogleCloudApigeeV1EntityMetadata": { "properties": { "lastModifiedAt": { "format": "int64", "description": "Time at which the API proxy was most recently modified, in milliseconds since epoch.", "type": "string" }, "createdAt": { "description": "Time at which the API proxy was created, in milliseconds since epoch.", "type": "string", "format": "int64" }, "subType": { "type": "string", "description": "The type of entity described" } }, "description": "Metadata common to many entities in this API.", "type": "object", "id": "GoogleCloudApigeeV1EntityMetadata" }, "GoogleCloudApigeeV1ProfileConfigMediation": { "id": "GoogleCloudApigeeV1ProfileConfigMediation", "description": "By default, following policies will be included: - OASValidation - SOAPMessageValidation", "type": "object", "properties": {} }, "GoogleCloudApigeeV1InstanceDeploymentStatusDeployedRoute": { "description": "Route deployed in the ingress routing table.", "properties": { "percentage": { "type": "integer", "description": "Percentage of ingress replicas reporting this route.", "format": "int32" }, "environment": { "description": "Destination environment. This will be empty if the route is not yet reported.", "type": "string" }, "basepath": { "description": "Base path in the routing table.", "type": "string" }, "envgroup": { "description": "Environment group where this route is installed.", "type": "string" } }, "id": "GoogleCloudApigeeV1InstanceDeploymentStatusDeployedRoute", "type": "object" }, "GoogleCloudApigeeV1SetAddonsRequest": { "id": "GoogleCloudApigeeV1SetAddonsRequest", "description": "Request for SetAddons.", "properties": { "addonsConfig": { "$ref": "GoogleCloudApigeeV1AddonsConfig", "description": "Required. Add-on configurations." } }, "type": "object" }, "GoogleCloudApigeeV1ApiDocDocumentationResponse": { "properties": { "message": { "readOnly": true, "description": "Output only. Description of the operation.", "type": "string" }, "data": { "description": "Output only. The documentation resource.", "$ref": "GoogleCloudApigeeV1ApiDocDocumentation", "readOnly": true }, "requestId": { "description": "Output only. Unique ID of the request.", "type": "string", "readOnly": true }, "errorCode": { "description": "Output only. Unique error code for the request, if any.", "readOnly": true, "type": "string" }, "status": { "description": "Output only. Status of the operation.", "readOnly": true, "type": "string" } }, "description": "The catalog item documentation wrapped with response status, error_code, etc.", "id": "GoogleCloudApigeeV1ApiDocDocumentationResponse", "type": "object" }, "GoogleCloudApigeeV1Score": { "description": "Represents Security Score.", "properties": { "subcomponents": { "type": "array", "items": { "$ref": "GoogleCloudApigeeV1ScoreComponent" }, "description": "List of all the drilldown score components." }, "timeRange": { "description": "Start and end time for the score.", "$ref": "GoogleTypeInterval" }, "component": { "description": "Component containing score, recommendations and actions.", "$ref": "GoogleCloudApigeeV1ScoreComponent" } }, "type": "object", "id": "GoogleCloudApigeeV1Score" }, "GoogleCloudApigeeV1SecurityReportQueryMetric": { "id": "GoogleCloudApigeeV1SecurityReportQueryMetric", "properties": { "aggregationFunction": { "type": "string", "description": "Aggregation function: avg, min, max, or sum." }, "operator": { "description": "One of `+`, `-`, `/`, `%`, `*`.", "type": "string" }, "alias": { "type": "string", "description": "Alias for the metric. Alias will be used to replace metric name in query results." }, "name": { "description": "Required. Metric name.", "type": "string" }, "value": { "type": "string", "description": "Operand value should be provided when operator is set." } }, "type": "object", "description": "Metric of the Query" }, "GoogleCloudApigeeV1ResourceFile": { "description": "Metadata about a resource file.", "type": "object", "properties": { "type": { "description": "Resource file type. {{ resource_file_type }}", "type": "string" }, "name": { "description": "ID of the resource file.", "type": "string" } }, "id": "GoogleCloudApigeeV1ResourceFile" }, "GoogleCloudApigeeV1OptimizedStatsResponse": { "id": "GoogleCloudApigeeV1OptimizedStatsResponse", "type": "object", "properties": { "stats": { "description": "`stats` results.", "$ref": "GoogleCloudApigeeV1OptimizedStatsNode" }, "resultTruncated": { "type": "boolean", "description": "Boolean flag that indicates whether the results were truncated based on the limit parameter." }, "metaData": { "$ref": "GoogleCloudApigeeV1Metadata", "description": "Metadata information about the query executed." }, "TimeUnit": { "type": "array", "items": { "format": "int64", "type": "string" }, "description": "List of time unit values. Time unit refers to an epoch timestamp value." } }, "description": "Encapsulates a response format for JavaScript Optimized Scenario." }, "GoogleCloudApigeeV1ListHybridIssuersResponse": { "properties": { "issuers": { "description": "Lists of hybrid services and its trusted issuer email ids.", "items": { "$ref": "GoogleCloudApigeeV1ServiceIssuersMapping" }, "type": "array" } }, "id": "GoogleCloudApigeeV1ListHybridIssuersResponse", "type": "object" }, "GoogleCloudApigeeV1ListSecurityProfileRevisionsResponse": { "id": "GoogleCloudApigeeV1ListSecurityProfileRevisionsResponse", "description": "Response for ListSecurityProfileRevisions.", "type": "object", "properties": { "securityProfiles": { "description": "List of security profile revisions. The revisions may be attached or unattached to any environment.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1SecurityProfile" } }, "nextPageToken": { "type": "string", "description": "A token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages." } } }, "GoogleCloudApigeeV1SecurityProfileScoringConfig": { "properties": { "description": { "type": "string", "description": "Description of the config." }, "scorePath": { "type": "string", "description": "Path of the component config used for scoring." }, "title": { "description": "Title of the config.", "type": "string" } }, "id": "GoogleCloudApigeeV1SecurityProfileScoringConfig", "type": "object", "description": "Security configurations to manage scoring." }, "GoogleRpcStatus": { "description": "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).", "type": "object", "id": "GoogleRpcStatus", "properties": { "code": { "description": "The status code, which should be an enum value of google.rpc.Code.", "type": "integer", "format": "int32" }, "message": { "type": "string", "description": "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." }, "details": { "type": "array", "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", "items": { "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, "type": "object" } } } }, "GoogleCloudApigeeV1ArchiveDeployment": { "description": "Archive Deployment information.", "properties": { "updatedAt": { "readOnly": true, "description": "Output only. The time at which the Archive Deployment was updated in milliseconds since the epoch.", "format": "int64", "type": "string" }, "labels": { "additionalProperties": { "type": "string" }, "type": "object", "description": "User-supplied key-value pairs used to organize ArchiveDeployments. Label keys must be between 1 and 63 characters long, have a UTF-8 encoding of maximum 128 bytes, and must conform to the following PCRE regular expression: \\p{Ll}\\p{Lo}{0,62} Label values must be between 1 and 63 characters long, have a UTF-8 encoding of maximum 128 bytes, and must conform to the following PCRE regular expression: [\\p{Ll}\\p{Lo}\\p{N}_-]{0,63} No more than 64 labels can be associated with a given store." }, "createdAt": { "type": "string", "format": "int64", "description": "Output only. The time at which the Archive Deployment was created in milliseconds since the epoch.", "readOnly": true }, "name": { "description": "Name of the Archive Deployment in the following format: `organizations/{org}/environments/{env}/archiveDeployments/{id}`.", "type": "string" }, "gcsUri": { "description": "Input only. The Google Cloud Storage signed URL returned from GenerateUploadUrl and used to upload the Archive zip file.", "type": "string" }, "operation": { "readOnly": true, "type": "string", "description": "Output only. A reference to the LRO that created this Archive Deployment in the following format: `organizations/{org}/operations/{id}`" } }, "id": "GoogleCloudApigeeV1ArchiveDeployment", "type": "object" }, "GoogleCloudApigeeV1ApiSecurityConfig": { "description": "Configurations of the API Security add-on.", "id": "GoogleCloudApigeeV1ApiSecurityConfig", "type": "object", "properties": { "expiresAt": { "description": "Output only. Time at which the API Security add-on expires in in milliseconds since epoch. If unspecified, the add-on will never expire.", "readOnly": true, "format": "int64", "type": "string" }, "enabled": { "description": "Flag that specifies whether the API security add-on is enabled.", "type": "boolean" } } }, "GoogleCloudApigeeV1ResourceConfig": { "properties": { "name": { "description": "Resource name in the following format: `organizations/{org}/environments/{env}/resourcefiles/{type}/{file}/revisions/{rev}` Only environment-scoped resource files are supported.", "type": "string" }, "location": { "description": "Location of the resource as a URI.", "type": "string" } }, "type": "object", "id": "GoogleCloudApigeeV1ResourceConfig" }, "GoogleCloudApigeeV1ListSecurityIncidentsResponse": { "description": "Response for ListSecurityIncidents.", "type": "object", "id": "GoogleCloudApigeeV1ListSecurityIncidentsResponse", "properties": { "securityIncidents": { "type": "array", "description": "List of security incidents in the organization", "items": { "$ref": "GoogleCloudApigeeV1SecurityIncident" } }, "nextPageToken": { "type": "string", "description": "A token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages." } } }, "GoogleCloudApigeeV1DeploymentChangeReportRoutingDeployment": { "properties": { "apiProxy": { "description": "Name of the deployed API proxy revision containing the base path.", "type": "string" }, "revision": { "description": "Name of the deployed API proxy revision containing the base path.", "type": "string" }, "environment": { "type": "string", "description": "Name of the environment in which the proxy is deployed." }, "basepath": { "type": "string", "description": "Base path receiving traffic." } }, "type": "object", "id": "GoogleCloudApigeeV1DeploymentChangeReportRoutingDeployment", "description": "Tuple representing a base path and the deployment containing it." }, "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestResourceArray": { "type": "object", "properties": { "resources": { "items": { "$ref": "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestResourceArrayResource" }, "type": "array", "description": "Required. The array of resources. For Apigee, the proxies are resources." } }, "description": "An array of resource messages.", "id": "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestResourceArray" }, "GoogleTypeMoney": { "properties": { "units": { "format": "int64", "type": "string", "description": "The whole units of the amount. For example if `currencyCode` is `\"USD\"`, then 1 unit is one US dollar." }, "nanos": { "format": "int32", "description": "Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.", "type": "integer" }, "currencyCode": { "type": "string", "description": "The three-letter currency code defined in ISO 4217." } }, "description": "Represents an amount of money with its currency type.", "type": "object", "id": "GoogleTypeMoney" }, "GoogleCloudApigeeV1ExportRequest": { "description": "Request body for [CreateExportRequest]", "id": "GoogleCloudApigeeV1ExportRequest", "properties": { "csvDelimiter": { "type": "string", "description": "Optional. Delimiter used in the CSV file, if `outputFormat` is set to `csv`. Defaults to the `,` (comma) character. Supported delimiter characters include comma (`,`), pipe (`|`), and tab (`\\t`)." }, "outputFormat": { "type": "string", "description": "Optional. Output format of the export. Valid values include: `csv` or `json`. Defaults to `json`. Note: Configure the delimiter for CSV output using the `csvDelimiter` property." }, "dateRange": { "$ref": "GoogleCloudApigeeV1DateRange", "description": "Required. Date range of the data to export." }, "datastoreName": { "type": "string", "description": "Required. Name of the preconfigured datastore." }, "name": { "type": "string", "description": "Required. Display name of the export job." }, "description": { "description": "Optional. Description of the export job.", "type": "string" } }, "type": "object" }, "GoogleCloudApigeeV1EnvironmentConfig": { "id": "GoogleCloudApigeeV1EnvironmentConfig", "type": "object", "properties": { "flowhooks": { "items": { "$ref": "GoogleCloudApigeeV1FlowHookConfig" }, "type": "array", "description": "List of flow hooks in the environment." }, "createTime": { "type": "string", "format": "google-datetime", "description": "Time that the environment configuration was created." }, "targets": { "description": "List of target servers in the environment. Disabled target servers are not displayed.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1TargetServerConfig" } }, "pubsubTopic": { "description": "Name of the PubSub topic for the environment.", "type": "string" }, "debugMask": { "description": "Debug mask that applies to all deployments in the environment.", "$ref": "GoogleCloudApigeeV1DebugMask" }, "name": { "type": "string", "description": "Name of the environment configuration in the following format: `organizations/{org}/environments/{env}/configs/{config}`" }, "resourceReferences": { "description": "List of resource references in the environment.", "items": { "$ref": "GoogleCloudApigeeV1ReferenceConfig" }, "type": "array" }, "sequenceNumber": { "type": "string", "format": "int64", "description": "DEPRECATED: Use revision_id." }, "uid": { "description": "Unique ID for the environment configuration. The ID will only change if the environment is deleted and recreated.", "type": "string" }, "envScopedRevisionId": { "format": "int64", "type": "string", "description": "Revision ID for environment-scoped resources (e.g. target servers, keystores) in this config. This ID will increment any time a resource not scoped to a deployment group changes." }, "deploymentGroups": { "description": "List of deployment groups in the environment.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1DeploymentGroupConfig" } }, "resources": { "items": { "$ref": "GoogleCloudApigeeV1ResourceConfig" }, "type": "array", "description": "List of resource versions in the environment." }, "arcConfigLocation": { "type": "string", "description": "The location for the config blob of API Runtime Control, aka Envoy Adapter, for op-based authentication as a URI, e.g. a Cloud Storage URI. This is only used by Envoy-based gateways." }, "forwardProxyUri": { "type": "string", "description": "The forward proxy's url to be used by the runtime. When set, runtime will send requests to the target via the given forward proxy. This is only used by programmable gateways." }, "traceConfig": { "$ref": "GoogleCloudApigeeV1RuntimeTraceConfig", "description": "Trace configurations. Contains config for the environment and config overrides for specific API proxies." }, "featureFlags": { "description": "Feature flags inherited from the organization and environment.", "additionalProperties": { "type": "string" }, "type": "object" }, "deployments": { "description": "List of deployments in the environment.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1DeploymentConfig" } }, "revisionId": { "type": "string", "description": "Revision ID of the environment configuration. The higher the value, the more recently the configuration was deployed.", "format": "int64" }, "dataCollectors": { "description": "List of data collectors used by the deployments in the environment.", "items": { "$ref": "GoogleCloudApigeeV1DataCollectorConfig" }, "type": "array" }, "gatewayConfigLocation": { "type": "string", "description": "The location for the gateway config blob as a URI, e.g. a Cloud Storage URI. This is only used by Envoy-based gateways." }, "addonsConfig": { "description": "The latest runtime configurations for add-ons.", "$ref": "GoogleCloudApigeeV1RuntimeAddonsConfig" }, "keystores": { "items": { "$ref": "GoogleCloudApigeeV1KeystoreConfig" }, "type": "array", "description": "List of keystores in the environment." }, "provider": { "type": "string", "description": "Used by the Control plane to add context information to help detect the source of the document during diagnostics and debugging." } } }, "GoogleCloudApigeeV1CommonNameConfig": { "id": "GoogleCloudApigeeV1CommonNameConfig", "properties": { "matchWildCards": { "type": "boolean" }, "name": { "type": "string" } }, "type": "object" }, "GoogleCloudApigeeV1OASDocumentation": { "properties": { "format": { "type": "string", "readOnly": true, "enumDescriptions": [ "The format is not available.", "YAML format.", "JSON format." ], "description": "Output only. The format of the input specification file contents.", "enum": [ "FORMAT_UNSPECIFIED", "YAML", "JSON" ] }, "spec": { "description": "Required. The documentation file contents for the OpenAPI Specification. JSON and YAML file formats are supported.", "$ref": "GoogleCloudApigeeV1DocumentationFile" } }, "type": "object", "description": "OpenAPI Specification documentation for a catalog item.", "id": "GoogleCloudApigeeV1OASDocumentation" }, "GoogleCloudApigeeV1DeploymentChangeReport": { "id": "GoogleCloudApigeeV1DeploymentChangeReport", "properties": { "routingConflicts": { "items": { "$ref": "GoogleCloudApigeeV1DeploymentChangeReportRoutingConflict" }, "type": "array", "description": "All base path conflicts detected for a deployment request." }, "routingChanges": { "description": "All routing changes that may result from a deployment request.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1DeploymentChangeReportRoutingChange" } }, "validationErrors": { "$ref": "GoogleRpcPreconditionFailure", "description": "Validation errors that would cause the deployment change request to be rejected." } }, "type": "object", "description": "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 base path in the proxy will not receive traffic due to an existing deployment having already claimed that base path. The presence of routing conflicts/changes will not cause non-dry-run DeployApiProxy/UndeployApiProxy requests to be rejected." }, "GoogleCloudApigeeV1ApiProductRef": { "properties": { "status": { "type": "string", "description": "Status of the API product. Valid values are `approved` or `revoked`." }, "apiproduct": { "type": "string", "description": "Name of the API product." } }, "id": "GoogleCloudApigeeV1ApiProductRef", "type": "object" }, "GoogleCloudApigeeV1ListCustomReportsResponse": { "type": "object", "id": "GoogleCloudApigeeV1ListCustomReportsResponse", "properties": { "qualifier": { "type": "array", "items": { "$ref": "GoogleCloudApigeeV1CustomReport" } } }, "description": "This message encapsulates a list of custom report definitions" }, "GoogleCloudApigeeV1Query": { "id": "GoogleCloudApigeeV1Query", "properties": { "dimensions": { "type": "array", "description": "A list of dimensions. https://docs.apigee.com/api-platform/analytics/analytics-reference#dimensions", "items": { "type": "string" } }, "envgroupHostname": { "type": "string", "description": "Hostname needs to be specified if query intends to run at host level. This field is only allowed when query is submitted by CreateHostAsyncQuery where analytics data will be grouped by organization and hostname." }, "outputFormat": { "type": "string", "description": "Valid values include: `csv` or `json`. Defaults to `json`. Note: Configure the delimiter for CSV output using the csvDelimiter property." }, "name": { "type": "string", "description": "Asynchronous Query Name." }, "groupByTimeUnit": { "description": "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.", "type": "string" }, "reportDefinitionId": { "type": "string", "description": "Asynchronous Report ID." }, "limit": { "type": "integer", "description": "Maximum number of rows that can be returned in the result.", "format": "int32" }, "metrics": { "type": "array", "description": "A list of Metrics.", "items": { "$ref": "GoogleCloudApigeeV1QueryMetric" } }, "csvDelimiter": { "type": "string", "description": "Delimiter used in the CSV file, if `outputFormat` is set to `csv`. Defaults to the `,` (comma) character. Supported delimiter characters include comma (`,`), pipe (`|`), and tab (`\\t`)." }, "filter": { "type": "string", "description": "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" }, "timeRange": { "type": "any", "description": "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\" }" } }, "type": "object" }, "GoogleCloudApigeeV1SecurityReportQuery": { "type": "object", "description": "Body structure when user makes a request to create a security report.", "properties": { "timeRange": { "description": "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\" }", "type": "any" }, "metrics": { "items": { "$ref": "GoogleCloudApigeeV1SecurityReportQueryMetric" }, "description": "A list of Metrics.", "type": "array" }, "reportDefinitionId": { "description": "Report Definition ID.", "type": "string" }, "csvDelimiter": { "description": "Delimiter used in the CSV file, if `outputFormat` is set to `csv`. Defaults to the `,` (comma) character. Supported delimiter characters include comma (`,`), pipe (`|`), and tab (`\\t`).", "type": "string" }, "limit": { "format": "int32", "type": "integer", "description": "Maximum number of rows that can be returned in the result." }, "filter": { "type": "string", "description": "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" }, "mimeType": { "description": "Valid values include: `csv` or `json`. Defaults to `json`. Note: Configure the delimiter for CSV output using the csvDelimiter property.", "type": "string" }, "groupByTimeUnit": { "type": "string", "description": "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." }, "dimensions": { "description": "A list of dimensions. https://docs.apigee.com/api-platform/analytics/analytics-reference#dimensions", "items": { "type": "string" }, "type": "array" }, "displayName": { "type": "string", "description": "Security Report display name which users can specify." }, "envgroupHostname": { "type": "string", "description": "Hostname needs to be specified if query intends to run at host level. This field is only allowed when query is submitted by CreateHostSecurityReport where analytics data will be grouped by organization and hostname." } }, "id": "GoogleCloudApigeeV1SecurityReportQuery" }, "GoogleIamV1Policy": { "properties": { "bindings": { "type": "array", "items": { "$ref": "GoogleIamV1Binding" }, "description": "Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`." }, "version": { "type": "integer", "format": "int32", "description": "Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)." }, "etag": { "description": "`etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost.", "type": "string", "format": "byte" }, "auditConfigs": { "type": "array", "description": "Specifies cloud audit logging configuration for this policy.", "items": { "$ref": "GoogleIamV1AuditConfig" } } }, "id": "GoogleIamV1Policy", "type": "object", "description": "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`, or principals, to a single `role`. Principals 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](https://cloud.google.com/iam/help/conditions/resource-policies). **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 \u003c 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 \u003c timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/)." }, "GoogleCloudApigeeV1ScoreComponentRecommendation": { "type": "object", "id": "GoogleCloudApigeeV1ScoreComponentRecommendation", "description": "Recommendation based on security concerns and score.", "properties": { "actions": { "description": "Actions for the recommendation to improve the security score.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1ScoreComponentRecommendationAction" } }, "impact": { "description": "Potential impact of this recommendation on the overall score. This denotes how important this recommendation is to improve the score.", "format": "int32", "type": "integer" }, "title": { "description": "Title represents recommendation title.", "type": "string" }, "description": { "description": "Description of the recommendation.", "type": "string" } } }, "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestResourceArrayResource": { "description": "Resource for which we are computing security assessment.", "id": "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestResourceArrayResource", "type": "object", "properties": { "type": { "type": "string", "enum": [ "RESOURCE_TYPE_UNSPECIFIED", "API_PROXY" ], "enumDescriptions": [ "ResourceType not specified.", "Resource is an Apigee Proxy." ], "description": "Required. Type of this resource." }, "name": { "type": "string", "description": "Required. Name of this resource." } } }, "GoogleCloudApigeeV1Attribute": { "type": "object", "id": "GoogleCloudApigeeV1Attribute", "description": "Key-value pair to store extra metadata.", "properties": { "value": { "type": "string", "description": "Value of the attribute." }, "name": { "type": "string", "description": "API key of the attribute." } } }, "GoogleCloudApigeeV1TraceConfig": { "description": "TraceConfig defines the configurations in an environment of distributed trace.", "id": "GoogleCloudApigeeV1TraceConfig", "properties": { "endpoint": { "type": "string", "description": "Required. Endpoint of the exporter." }, "exporter": { "enumDescriptions": [ "Exporter unspecified", "Jaeger exporter", "Cloudtrace exporter" ], "type": "string", "description": "Required. Exporter that is used to view the distributed trace captured using OpenCensus. An exporter sends traces to any backend that is capable of consuming them. Recorded spans can be exported by registered exporters.", "enum": [ "EXPORTER_UNSPECIFIED", "JAEGER", "CLOUD_TRACE" ] }, "samplingConfig": { "$ref": "GoogleCloudApigeeV1TraceSamplingConfig", "description": "Distributed trace configuration for all API proxies in an environment. You can also override the configuration for a specific API proxy using the distributed trace configuration overrides API." } }, "type": "object" }, "GoogleCloudApigeeV1SchemaSchemaElement": { "description": "Message type for the schema element", "properties": { "properties": { "$ref": "GoogleCloudApigeeV1SchemaSchemaProperty", "description": "Properties for the schema field. For example: { \"createTime\": \"2016-02-26T10:23:09.592Z\", \"custom\": \"false\", \"type\": \"string\" }" }, "name": { "description": "Name of the field.", "type": "string" } }, "id": "GoogleCloudApigeeV1SchemaSchemaElement", "type": "object" }, "GoogleRpcPreconditionFailureViolation": { "id": "GoogleRpcPreconditionFailureViolation", "properties": { "subject": { "type": "string", "description": "The subject, relative to the type, that failed. For example, \"google.com/cloud\" relative to the \"TOS\" type would indicate which terms of service is being referenced." }, "description": { "type": "string", "description": "A description of how the precondition failed. Developers can use this description to understand how to fix the failure. For example: \"Terms of service not accepted\"." }, "type": { "type": "string", "description": "The type of PreconditionFailure. We recommend using a service-specific enum type to define the supported precondition violation subjects. For example, \"TOS\" for \"Terms of Service violation\"." } }, "description": "A message type used to describe a single precondition failure.", "type": "object" }, "GoogleCloudApigeeV1ScoreComponentRecommendationActionActionContext": { "properties": { "documentationLink": { "type": "string", "description": "Documentation link for the action." } }, "type": "object", "id": "GoogleCloudApigeeV1ScoreComponentRecommendationActionActionContext", "description": "Action context are all the relevant details for the action." }, "GoogleCloudApigeeV1ListRatePlansResponse": { "properties": { "nextStartKey": { "description": "Value that can be sent as `startKey` to retrieve the next page of content. If this field is omitted, there are no subsequent pages.", "type": "string" }, "ratePlans": { "type": "array", "description": "List of rate plans in an organization.", "items": { "$ref": "GoogleCloudApigeeV1RatePlan" } } }, "type": "object", "description": "Response for ListRatePlans.", "id": "GoogleCloudApigeeV1ListRatePlansResponse" }, "GoogleCloudApigeeV1AsyncQueryResultView": { "type": "object", "properties": { "code": { "format": "int32", "type": "integer", "description": "Error code when there is a failure." }, "state": { "type": "string", "description": "State of retrieving ResultView." }, "rows": { "type": "array", "items": { "type": "any" }, "description": "Rows of query result. Each row is a JSON object. Example: {sum(message_count): 1, developer_app: \"(not set)\",…}" }, "metadata": { "$ref": "GoogleCloudApigeeV1QueryMetadata", "description": "Metadata contains information like metrics, dimenstions etc of the AsyncQuery." }, "error": { "type": "string", "description": "Error message when there is a failure." } }, "id": "GoogleCloudApigeeV1AsyncQueryResultView" }, "GoogleCloudApigeeV1ListDeveloperSubscriptionsResponse": { "properties": { "nextStartKey": { "type": "string", "description": "Value that can be sent as `startKey` to retrieve the next page of content. If this field is omitted, there are no subsequent pages." }, "developerSubscriptions": { "items": { "$ref": "GoogleCloudApigeeV1DeveloperSubscription" }, "description": "List of all subscriptions.", "type": "array" } }, "id": "GoogleCloudApigeeV1ListDeveloperSubscriptionsResponse", "description": "Response for ListDeveloperSubscriptions.", "type": "object" }, "GoogleCloudApigeeV1SecurityActionsConfig": { "description": "SecurityActionsConfig reflects the current state of the SecurityActions feature. This is a singleton resource: https://google.aip.dev/156", "id": "GoogleCloudApigeeV1SecurityActionsConfig", "type": "object", "properties": { "updateTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. The update time for configuration.", "type": "string" }, "name": { "description": "This is a singleton resource, the name will always be set by SecurityActions and any user input will be ignored. The name is always: `organizations/{org}/environments/{env}/security_actions_config`", "type": "string" }, "enabled": { "type": "boolean", "description": "The flag that controls whether this feature is enabled. This is `unset` by default. When this flag is `false`, even if individual rules are enabled, no SecurityActions will be enforced." } } }, "GoogleCloudApigeeV1ListDataCollectorsResponse": { "description": "Response for ListDataCollectors.", "id": "GoogleCloudApigeeV1ListDataCollectorsResponse", "properties": { "nextPageToken": { "description": "Page token that you can include in a ListDataCollectors request to retrieve the next page. If omitted, no subsequent pages exist.", "type": "string" }, "dataCollectors": { "items": { "$ref": "GoogleCloudApigeeV1DataCollector" }, "description": "Data collectors in the specified organization.", "type": "array" } }, "type": "object" }, "GoogleCloudApigeeV1QueryTimeSeriesStatsResponseSequence": { "properties": { "points": { "description": "List of points. First value of each inner list is a timestamp.", "items": { "items": { "type": "any" }, "type": "array" }, "type": "array" }, "dimensions": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Map of dimensions and their values that uniquely identifies a time series sequence." } }, "id": "GoogleCloudApigeeV1QueryTimeSeriesStatsResponseSequence", "description": "A sequence of time series.", "type": "object" }, "GoogleCloudApigeeV1SecurityReportMetadata": { "description": "Metadata for the security report.", "properties": { "mimeType": { "type": "string", "description": "MIME type / Output format." }, "timeUnit": { "type": "string", "description": "Query GroupBy time unit. Example: \"seconds\", \"minute\", \"hour\"" }, "startTimestamp": { "description": "Start timestamp of the query range.", "format": "google-datetime", "type": "string" }, "dimensions": { "type": "array", "items": { "type": "string" }, "description": "Dimensions of the SecurityReport." }, "metrics": { "description": "Metrics of the SecurityReport. Example: [\"name:bot_count,func:sum,alias:sum_bot_count\"]", "type": "array", "items": { "type": "string" } }, "endTimestamp": { "type": "string", "format": "google-datetime", "description": "End timestamp of the query range." } }, "type": "object", "id": "GoogleCloudApigeeV1SecurityReportMetadata" }, "GoogleCloudApigeeV1Session": { "type": "object", "properties": { "timestampMs": { "type": "string", "format": "int64", "description": "The first transaction creation timestamp in millisecond, recorded by UAP." }, "id": { "description": "The debug session ID.", "type": "string" } }, "id": "GoogleCloudApigeeV1Session", "description": "Session carries the debug session id and its creation time." }, "GoogleIamV1Binding": { "properties": { "members": { "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.", "items": { "type": "string" }, "type": "array" }, "condition": { "$ref": "GoogleTypeExpr", "description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)." }, "role": { "description": "Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles).", "type": "string" } }, "id": "GoogleIamV1Binding", "type": "object", "description": "Associates `members`, or principals, with a `role`." }, "GoogleCloudApigeeV1CreditDeveloperBalanceRequest": { "properties": { "transactionId": { "description": "Each transaction_id uniquely identifies a credit balance request. If multiple requests are received with the same transaction_id, only one of them will be considered.", "type": "string" }, "transactionAmount": { "description": "The amount of money to be credited. The wallet corresponding to the currency specified within `transaction_amount` will be updated. For example, if you specified `currency_code` within `transaction_amount` as \"USD\", then the amount would be added to the wallet which has the \"USD\" currency or if no such wallet exists, a new wallet will be created with the \"USD\" currency.", "$ref": "GoogleTypeMoney" } }, "description": "Request for CreditDeveloperBalance.", "id": "GoogleCloudApigeeV1CreditDeveloperBalanceRequest", "type": "object" }, "GoogleCloudApigeeV1ListKeyValueEntriesResponse": { "description": "The request structure for listing key value map keys and its corresponding values.", "type": "object", "id": "GoogleCloudApigeeV1ListKeyValueEntriesResponse", "properties": { "nextPageToken": { "type": "string", "description": "Token that can be sent as `next_page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages." }, "keyValueEntries": { "description": "One or more key value map keys and values.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" } } } }, "GoogleCloudApigeeV1TargetServer": { "id": "GoogleCloudApigeeV1TargetServer", "description": "TargetServer configuration. TargetServers are used to decouple a proxy TargetEndpoint HTTPTargetConnections from concrete URLs for backend services.", "properties": { "sSLInfo": { "$ref": "GoogleCloudApigeeV1TlsInfo", "description": "Optional. Specifies TLS configuration info for this TargetServer. The JSON name is `sSLInfo` for legacy/backwards compatibility reasons -- Edge originally supported SSL, and the name is still used for TLS configuration." }, "name": { "description": "Required. The resource id of this target server. Values must match the regular expression ", "type": "string" }, "description": { "type": "string", "description": "Optional. A human-readable description of this TargetServer." }, "port": { "type": "integer", "description": "Required. The port number this target connects to on the given host. Value must be between 1 and 65535, inclusive.", "format": "int32" }, "isEnabled": { "type": "boolean", "description": "Optional. Enabling/disabling a TargetServer is useful when TargetServers are used in load balancing configurations, and one or more TargetServers need to taken out of rotation periodically. Defaults to true." }, "host": { "type": "string", "description": "Required. The host name this target connects to. Value must be a valid hostname as described by RFC-1123." }, "protocol": { "enumDescriptions": [ "UNSPECIFIED defaults to HTTP for backwards compatibility.", "The TargetServer uses HTTP.", "The TargetSever uses HTTP2.", "The TargetServer uses GRPC.", "GRPC TargetServer to be used in ExternalCallout Policy. Prefer to use EXTERNAL_CALLOUT instead. TODO(b/266125112) deprecate once EXTERNAL _CALLOUT generally available.", "The TargetServer is to be used in the ExternalCallout Policy" ], "type": "string", "enum": [ "PROTOCOL_UNSPECIFIED", "HTTP", "HTTP2", "GRPC_TARGET", "GRPC", "EXTERNAL_CALLOUT" ], "description": "Immutable. The protocol used by this TargetServer." } }, "type": "object" }, "GoogleCloudApigeeV1ApiProxy": { "id": "GoogleCloudApigeeV1ApiProxy", "type": "object", "properties": { "metaData": { "description": "Output only. Metadata describing the API proxy.", "readOnly": true, "$ref": "GoogleCloudApigeeV1EntityMetadata" }, "latestRevisionId": { "type": "string", "readOnly": true, "description": "Output only. The id of the most recently created revision for this api proxy." }, "labels": { "description": "User labels applied to this API Proxy.", "type": "object", "additionalProperties": { "type": "string" } }, "apiProxyType": { "readOnly": true, "enum": [ "API_PROXY_TYPE_UNSPECIFIED", "PROGRAMMABLE", "CONFIGURABLE" ], "enumDescriptions": [ "API proxy type not specified.", "Programmable API Proxies enable you to develop APIs with highly flexible behavior using bundled policy configuration and one or more programming languages to describe complex sequential and/or conditional flows of logic.", "Configurable API Proxies enable you to develop efficient APIs using simple configuration while complex execution control flow logic is handled by Apigee. This type only works with the ARCHIVE deployment type and cannot be combined with the PROXY deployment type." ], "type": "string", "description": "Output only. The type of the API proxy." }, "name": { "readOnly": true, "type": "string", "description": "Output only. Name of the API proxy." }, "readOnly": { "description": "Output only. Whether this proxy is read-only. A read-only proxy cannot have new revisions created through calls to CreateApiProxyRevision. A proxy is read-only if it was generated by an archive.", "readOnly": true, "type": "boolean" }, "revision": { "items": { "type": "string" }, "description": "Output only. List of revisions defined for the API proxy.", "readOnly": true, "type": "array" } }, "description": "Metadata describing the API proxy" }, "GoogleCloudApigeeV1ScoreComponent": { "type": "object", "properties": { "recommendations": { "description": "List of recommendations to improve API security.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1ScoreComponentRecommendation" } }, "dataCaptureTime": { "format": "google-datetime", "description": "Time in the requested time period when data was last captured to compute the score.", "type": "string" }, "score": { "description": "Score for the component.", "format": "int32", "type": "integer" }, "drilldownPaths": { "type": "array", "description": "List of paths for next components.", "items": { "type": "string" } }, "calculateTime": { "format": "google-datetime", "description": "Time when score was calculated.", "type": "string" }, "scorePath": { "type": "string", "description": "Path of the component. Example: /org@myorg/envgroup@myenvgroup/proxies/proxy@myproxy" } }, "id": "GoogleCloudApigeeV1ScoreComponent", "description": "Component is an individual security element that is scored." }, "GoogleCloudApigeeV1EndpointAttachment": { "type": "object", "properties": { "location": { "type": "string", "description": "Required. Location of the endpoint attachment." }, "name": { "description": "Name of the endpoint attachment. Use the following structure in your request: `organizations/{org}/endpointAttachments/{endpoint_attachment}`", "type": "string" }, "connectionState": { "description": "Output only. State of the endpoint attachment connection to the service attachment.", "enum": [ "CONNECTION_STATE_UNSPECIFIED", "UNAVAILABLE", "PENDING", "ACCEPTED", "REJECTED", "CLOSED", "FROZEN", "NEEDS_ATTENTION" ], "type": "string", "enumDescriptions": [ "The connection state has not been set.", "The connection state is unavailable at this time, possibly because the endpoint attachment is currently being provisioned.", "The connection is pending acceptance by the PSC producer.", "The connection has been accepted by the PSC producer.", "The connection has been rejected by the PSC producer.", "The connection has been closed by the PSC producer and will not serve traffic going forward.", "The connection has been frozen by the PSC producer and will not serve traffic.", "The connection has been accepted by the PSC producer, but it is not ready to serve the traffic due to producer side issues." ], "readOnly": true }, "serviceAttachment": { "type": "string", "description": "Format: projects/*/regions/*/serviceAttachments/*" }, "state": { "readOnly": true, "description": "Output only. State of the endpoint attachment. Values other than `ACTIVE` mean the resource is not ready to use.", "enum": [ "STATE_UNSPECIFIED", "CREATING", "ACTIVE", "DELETING", "UPDATING" ], "type": "string", "enumDescriptions": [ "Resource is in an unspecified state.", "Resource is being created.", "Resource is provisioned and ready to use.", "The resource is being deleted.", "The resource is being updated." ] }, "host": { "type": "string", "readOnly": true, "description": "Output only. Host that can be used in either the HTTP target endpoint directly or as the host in target server." } }, "id": "GoogleCloudApigeeV1EndpointAttachment", "description": "Apigee endpoint attachment. For more information, see [Southbound networking patterns] (https://cloud.google.com/apigee/docs/api-platform/architecture/southbound-networking-patterns-endpoints)." }, "GoogleIamV1TestIamPermissionsResponse": { "properties": { "permissions": { "items": { "type": "string" }, "type": "array", "description": "A subset of `TestPermissionsRequest.permissions` that the caller is allowed." } }, "description": "Response message for `TestIamPermissions` method.", "type": "object", "id": "GoogleIamV1TestIamPermissionsResponse" }, "GoogleCloudApigeeV1ReportInstanceStatusResponse": { "type": "object", "properties": {}, "description": "Placeholder for future enhancements to status reporting protocol", "id": "GoogleCloudApigeeV1ReportInstanceStatusResponse" }, "GoogleCloudApigeeV1Property": { "properties": { "name": { "description": "The property key", "type": "string" }, "value": { "description": "The property value", "type": "string" } }, "description": "A single property entry in the Properties message.", "type": "object", "id": "GoogleCloudApigeeV1Property" }, "EdgeConfigstoreBundleBadBundleViolation": { "description": "A message type used to describe a single bundle validation error.", "type": "object", "id": "EdgeConfigstoreBundleBadBundleViolation", "properties": { "description": { "type": "string", "description": "A description of why the bundle is invalid and how to fix it." }, "filename": { "type": "string", "description": "The filename (including relative path from the bundle root) in which the error occurred." } } }, "GoogleCloudApigeeV1SecurityProfile": { "type": "object", "id": "GoogleCloudApigeeV1SecurityProfile", "description": "Represents a SecurityProfile resource.", "properties": { "name": { "type": "string", "description": "Immutable. Name of the security profile resource. Format: organizations/{org}/securityProfiles/{profile}" }, "displayName": { "deprecated": true, "type": "string", "description": "DEPRECATED: DO NOT USE Display name of the security profile." }, "revisionUpdateTime": { "readOnly": true, "type": "string", "description": "Output only. The time when revision was updated.", "format": "google-datetime" }, "minScore": { "description": "Output only. Minimum security score that can be generated by this profile.", "readOnly": true, "type": "integer", "format": "int32" }, "scoringConfigs": { "type": "array", "description": "List of profile scoring configs in this revision.", "items": { "$ref": "GoogleCloudApigeeV1SecurityProfileScoringConfig" } }, "revisionPublishTime": { "type": "string", "description": "Output only. DEPRECATED: DO NOT USE The time when revision was published. Once published, the security profile revision cannot be updated further and can be attached to environments.", "format": "google-datetime", "deprecated": true, "readOnly": true }, "description": { "type": "string", "description": "Description of the security profile." }, "revisionId": { "type": "string", "readOnly": true, "description": "Output only. Revision ID of the security profile.", "format": "int64" }, "revisionCreateTime": { "type": "string", "description": "Output only. The time when revision was created.", "readOnly": true, "format": "google-datetime" }, "profileConfig": { "$ref": "GoogleCloudApigeeV1ProfileConfig", "description": "Required. Customized profile configuration that computes the security score." }, "environments": { "description": "List of environments attached to security profile.", "items": { "$ref": "GoogleCloudApigeeV1SecurityProfileEnvironment" }, "type": "array" }, "maxScore": { "format": "int32", "description": "Output only. Maximum security score that can be generated by this profile.", "readOnly": true, "type": "integer" } } }, "GoogleCloudApigeeV1ApiCategory": { "properties": { "id": { "description": "ID of the category (a UUID).", "type": "string" }, "siteId": { "description": "Name of the portal.", "type": "string" }, "name": { "type": "string", "description": "Name of the category." }, "updateTime": { "description": "Time the category was last modified in milliseconds since epoch.", "format": "int64", "type": "string" } }, "id": "GoogleCloudApigeeV1ApiCategory", "type": "object", "description": "`ApiCategory` represents an API category. [Catalog items](/apigee/docs/reference/apis/apigee/rest/v1/organizations.sites.apidocs) can be tagged with API categories; users viewing the API catalog in the portal will have the option to browse the catalog by category." }, "GoogleCloudApigeeV1AdjustDeveloperBalanceRequest": { "id": "GoogleCloudApigeeV1AdjustDeveloperBalanceRequest", "properties": { "adjustment": { "description": "* A positive value of `adjustment` means that that the API provider wants to adjust the balance for an under-charged developer i.e. the balance of the developer will decrease. * A negative value of `adjustment` means that that the API provider wants to adjust the balance for an over-charged developer i.e. the balance of the developer will increase.", "$ref": "GoogleTypeMoney" } }, "description": "Request for AdjustDeveloperBalance.", "type": "object" }, "GoogleCloudApigeeV1DeleteCustomReportResponse": { "type": "object", "id": "GoogleCloudApigeeV1DeleteCustomReportResponse", "properties": { "message": { "description": "The response contains only a message field.", "type": "string" } } }, "GoogleCloudApigeeV1IngressConfig": { "id": "GoogleCloudApigeeV1IngressConfig", "type": "object", "properties": { "revisionId": { "type": "string", "format": "int64", "description": "Revision id that defines the ordering on IngressConfig resources. The higher the revision, the more recently the configuration was deployed." }, "revisionCreateTime": { "format": "google-datetime", "type": "string", "description": "Time at which the IngressConfig revision was created." }, "environmentGroups": { "description": "List of environment groups in the organization.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1EnvironmentGroupConfig" } }, "name": { "type": "string", "description": "Name of the resource in the following format: `organizations/{org}/deployedIngressConfig`." }, "uid": { "description": "A unique id for the ingress config that will only change if the organization is deleted and recreated.", "type": "string" } } }, "GoogleCloudApigeeV1GetSyncAuthorizationRequest": { "id": "GoogleCloudApigeeV1GetSyncAuthorizationRequest", "properties": {}, "description": "Request for GetSyncAuthorization.", "type": "object" }, "GoogleCloudApigeeV1SharedFlow": { "description": "The metadata describing a shared flow", "properties": { "metaData": { "$ref": "GoogleCloudApigeeV1EntityMetadata", "description": "Metadata describing the shared flow." }, "name": { "type": "string", "description": "The ID of the shared flow." }, "latestRevisionId": { "type": "string", "description": "The id of the most recently created revision for this shared flow." }, "revision": { "type": "array", "description": "A list of revisions of this shared flow.", "items": { "type": "string" } } }, "id": "GoogleCloudApigeeV1SharedFlow", "type": "object" }, "GoogleCloudApigeeV1ListInstanceAttachmentsResponse": { "properties": { "attachments": { "type": "array", "description": "Attachments for the instance.", "items": { "$ref": "GoogleCloudApigeeV1InstanceAttachment" } }, "nextPageToken": { "description": "Page token that you can include in a ListInstanceAttachments request to retrieve the next page of content. If omitted, no subsequent pages exist.", "type": "string" } }, "description": "Response for ListInstanceAttachments.", "type": "object", "id": "GoogleCloudApigeeV1ListInstanceAttachmentsResponse" }, "GoogleCloudApigeeV1SecurityAssessmentResultScoringResultAssessmentRecommendationRecommendation": { "type": "object", "properties": { "link": { "$ref": "GoogleCloudApigeeV1SecurityAssessmentResultScoringResultAssessmentRecommendationRecommendationLink", "description": "The link for the recommendation." }, "description": { "type": "string", "description": "The description of the recommendation." } }, "description": "The format of the assessment recommendation.", "id": "GoogleCloudApigeeV1SecurityAssessmentResultScoringResultAssessmentRecommendationRecommendation" }, "GoogleCloudApigeeV1DebugMask": { "id": "GoogleCloudApigeeV1DebugMask", "properties": { "requestJSONPaths": { "type": "array", "items": { "type": "string" }, "description": "List of JSON paths that specify the JSON elements to be filtered from JSON request message payloads." }, "responseJSONPaths": { "items": { "type": "string" }, "type": "array", "description": "List of JSON paths that specify the JSON elements to be filtered from JSON response message payloads." }, "namespaces": { "additionalProperties": { "type": "string" }, "type": "object", "description": "Map of namespaces to URIs." }, "responseXPaths": { "type": "array", "description": "List of XPaths that specify the XML elements to be filtered from XML response message payloads.", "items": { "type": "string" } }, "variables": { "items": { "type": "string" }, "type": "array", "description": "List of variables that should be masked from the debug output." }, "requestXPaths": { "description": "List of XPaths that specify the XML elements to be filtered from XML request message payloads.", "type": "array", "items": { "type": "string" } }, "faultJSONPaths": { "description": "List of JSON paths that specify the JSON elements to be filtered from JSON payloads in error flows.", "type": "array", "items": { "type": "string" } }, "faultXPaths": { "items": { "type": "string" }, "type": "array", "description": "List of XPaths that specify the XML elements to be filtered from XML payloads in error flows." }, "name": { "type": "string", "description": "Name of the debug mask." } }, "type": "object" }, "GoogleCloudApigeeV1AnalyticsConfig": { "id": "GoogleCloudApigeeV1AnalyticsConfig", "description": "Configuration for the Analytics add-on.", "type": "object", "properties": { "state": { "type": "string", "enumDescriptions": [ "Default value.", "Add-on is in progress of enabling.", "Add-on is fully enabled and ready to use.", "Add-on is in progress of disabling.", "Add-on is fully disabled." ], "enum": [ "ADDON_STATE_UNSPECIFIED", "ENABLING", "ENABLED", "DISABLING", "DISABLED" ], "readOnly": true, "description": "Output only. The state of the Analytics add-on." }, "updateTime": { "format": "google-datetime", "type": "string", "description": "Output only. The latest update time.", "readOnly": true }, "expireTimeMillis": { "type": "string", "format": "int64", "readOnly": true, "description": "Output only. Time at which the Analytics add-on expires in milliseconds since epoch. If unspecified, the add-on will never expire." }, "enabled": { "type": "boolean", "description": "Whether the Analytics add-on is enabled." } } }, "GoogleCloudApigeeV1KeyValueMap": { "properties": { "encrypted": { "type": "boolean", "description": "Required. Flag that specifies whether entry values will be encrypted. This field is retained for backward compatibility and the value of encrypted will always be `true`. Apigee X and hybrid do not support unencrypted key value maps." }, "name": { "description": "Required. ID of the key value map.", "type": "string" } }, "type": "object", "description": "Collection of key/value string pairs.", "id": "GoogleCloudApigeeV1KeyValueMap" }, "GoogleCloudApigeeV1ConfigVersion": { "properties": { "minorVersion": { "type": "integer", "description": "Minor version of the API proxy configuration schema.", "format": "int32" }, "majorVersion": { "description": "Major version of the API proxy configuration schema.", "type": "integer", "format": "int32" } }, "description": "Version of the API proxy configuration schema. Currently, only 4.0 is supported.", "id": "GoogleCloudApigeeV1ConfigVersion", "type": "object" }, "GoogleCloudApigeeV1MetricAggregation": { "type": "object", "id": "GoogleCloudApigeeV1MetricAggregation", "properties": { "name": { "description": "Name of the metric", "type": "string" }, "order": { "type": "string", "enum": [ "ORDER_UNSPECIFIED", "ASCENDING", "DESCENDING" ], "enumDescriptions": [ "Unspecified order. Default is Descending.", "Ascending sort order.", "Descending sort order." ], "description": "Ordering for this aggregation in the result. For time series this is ignored since the ordering of points depends only on the timestamp, not the values." }, "aggregation": { "enum": [ "AGGREGATION_FUNCTION_UNSPECIFIED", "AVG", "SUM", "MIN", "MAX", "COUNT_DISTINCT" ], "type": "string", "enumDescriptions": [ "Unspecified Aggregation function.", "Average.", "Summation.", "Min.", "Max.", "Count distinct" ], "description": "Aggregation function associated with the metric." } }, "description": "The optionally aggregated metric to query with its ordering." }, "GoogleCloudApigeeV1ApiDocResponse": { "id": "GoogleCloudApigeeV1ApiDocResponse", "description": "The catalog item resource wrapped with response status, error_code, etc.", "properties": { "data": { "description": "The catalog item resource.", "$ref": "GoogleCloudApigeeV1ApiDoc" }, "errorCode": { "type": "string", "description": "Unique error code for the request, if any." }, "status": { "type": "string", "description": "Status of the operation." }, "message": { "description": "Description of the operation.", "type": "string" }, "requestId": { "type": "string", "description": "Unique ID of the request." } }, "type": "object" }, "GoogleCloudApigeeV1ApiCategoryResponse": { "properties": { "errorCode": { "description": "Unique error code for the request, if any.", "type": "string" }, "status": { "description": "Status of the operation.", "type": "string" }, "message": { "description": "Description of the operation.", "type": "string" }, "requestId": { "type": "string", "description": "Unique ID of the request." }, "data": { "$ref": "GoogleCloudApigeeV1ApiCategory", "description": "The API category resource." } }, "description": "The API category resource wrapped with response status, error_code, etc.", "type": "object", "id": "GoogleCloudApigeeV1ApiCategoryResponse" }, "EdgeConfigstoreBundleBadBundle": { "description": "Describes why a bundle is invalid. Intended for use in error details.", "id": "EdgeConfigstoreBundleBadBundle", "type": "object", "properties": { "violations": { "description": "Describes all precondition violations.", "type": "array", "items": { "$ref": "EdgeConfigstoreBundleBadBundleViolation" } } } }, "GoogleCloudApigeeV1InstanceAttachment": { "properties": { "name": { "description": "Output only. ID of the attachment.", "readOnly": true, "type": "string" }, "environment": { "type": "string", "description": "ID of the attached environment." }, "createdAt": { "type": "string", "format": "int64", "description": "Output only. Time the attachment was created in milliseconds since epoch.", "readOnly": true } }, "type": "object", "id": "GoogleCloudApigeeV1InstanceAttachment", "description": "InstanceAttachment represents the installation of an environment onto an instance." }, "GoogleIamV1AuditLogConfig": { "description": "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.", "properties": { "exemptedMembers": { "items": { "type": "string" }, "type": "array", "description": "Specifies the identities that do not cause logging for this type of permission. Follows the same format of Binding.members." }, "logType": { "enumDescriptions": [ "Default case. Should never be this.", "Admin reads. Example: CloudIAM getIamPolicy", "Data writes. Example: CloudSQL Users create", "Data reads. Example: CloudSQL Users list" ], "enum": [ "LOG_TYPE_UNSPECIFIED", "ADMIN_READ", "DATA_WRITE", "DATA_READ" ], "description": "The log type that this config enables.", "type": "string" } }, "id": "GoogleIamV1AuditLogConfig", "type": "object" }, "GoogleLongrunningOperation": { "type": "object", "description": "This resource represents a long-running operation that is the result of a network API call.", "properties": { "response": { "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "type": "object", "description": "The normal, successful response of the operation. 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`." }, "error": { "description": "The error result of the operation in case of failure or cancellation.", "$ref": "GoogleRpcStatus" }, "done": { "type": "boolean", "description": "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." }, "metadata": { "description": "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.", "type": "object", "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", "type": "any" } }, "name": { "description": "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}`.", "type": "string" } }, "id": "GoogleLongrunningOperation" }, "GoogleCloudApigeeV1AddonsConfig": { "properties": { "monetizationConfig": { "description": "Configuration for the Monetization add-on.", "$ref": "GoogleCloudApigeeV1MonetizationConfig" }, "advancedApiOpsConfig": { "description": "Configuration for the Advanced API Ops add-on.", "$ref": "GoogleCloudApigeeV1AdvancedApiOpsConfig" }, "integrationConfig": { "description": "Configuration for the Integration add-on.", "$ref": "GoogleCloudApigeeV1IntegrationConfig" }, "connectorsPlatformConfig": { "description": "Configuration for the Connectors Platform add-on.", "$ref": "GoogleCloudApigeeV1ConnectorsPlatformConfig" }, "apiSecurityConfig": { "$ref": "GoogleCloudApigeeV1ApiSecurityConfig", "description": "Configuration for the API Security add-on." }, "analyticsConfig": { "description": "Configuration for the Analytics add-on.", "$ref": "GoogleCloudApigeeV1AnalyticsConfig" } }, "type": "object", "description": "Add-on configurations for the Apigee organization.", "id": "GoogleCloudApigeeV1AddonsConfig" }, "GoogleCloudApigeeV1AdvancedApiOpsConfig": { "type": "object", "id": "GoogleCloudApigeeV1AdvancedApiOpsConfig", "description": "Configuration for the Advanced API Ops add-on.", "properties": { "enabled": { "type": "boolean", "description": "Flag that specifies whether the Advanced API Ops add-on is enabled." } } }, "GoogleCloudApigeeV1SecurityAssessmentResultScoringResultAssessmentRecommendation": { "properties": { "weight": { "enum": [ "WEIGHT_UNSPECIFIED", "MINOR", "MODERATE", "MAJOR" ], "enumDescriptions": [ "The weight is unspecified.", "The weight is minor.", "The weight is moderate.", "The weight is major." ], "description": "The weight of the assessment which was set in the profile.", "type": "string" }, "verdict": { "description": "Verdict indicates the assessment result.", "enumDescriptions": [ "The verdict is unspecified.", "The assessment has passed.", "The assessment has failed." ], "enum": [ "VERDICT_UNSPECIFIED", "PASS", "FAIL" ], "type": "string" }, "recommendations": { "description": "The recommended steps of the assessment.", "items": { "$ref": "GoogleCloudApigeeV1SecurityAssessmentResultScoringResultAssessmentRecommendationRecommendation" }, "type": "array" }, "displayName": { "type": "string", "description": "The display name of the assessment." }, "scoreImpact": { "type": "integer", "description": "Score impact indicates the impact on the overall score if the assessment were to pass.", "format": "int32" } }, "type": "object", "id": "GoogleCloudApigeeV1SecurityAssessmentResultScoringResultAssessmentRecommendation", "description": "The message format of a recommendation from the assessment." }, "GoogleCloudApigeeV1Schema": { "id": "GoogleCloudApigeeV1Schema", "type": "object", "description": "Response for Schema call", "properties": { "meta": { "type": "array", "items": { "type": "string" }, "description": "Additional metadata associated with schema. This is a legacy field and usually consists of an empty array of strings." }, "dimensions": { "description": "List of schema fields grouped as dimensions.", "items": { "$ref": "GoogleCloudApigeeV1SchemaSchemaElement" }, "type": "array" }, "metrics": { "type": "array", "items": { "$ref": "GoogleCloudApigeeV1SchemaSchemaElement" }, "description": "List of schema fields grouped as dimensions that can be used with an aggregate function such as `sum`, `avg`, `min`, and `max`." } } }, "GoogleCloudApigeeV1AliasRevisionConfig": { "id": "GoogleCloudApigeeV1AliasRevisionConfig", "type": "object", "properties": { "name": { "type": "string", "description": "Name of the alias revision included in the keystore in the following format: `organizations/{org}/environments/{env}/keystores/{keystore}/aliases/{alias}/revisions/{rev}`" }, "type": { "enum": [ "ALIAS_TYPE_UNSPECIFIED", "CERT", "KEY_CERT" ], "enumDescriptions": [ "Alias type is not specified.", "Certificate.", "Key/certificate pair." ], "type": "string" }, "location": { "type": "string", "description": "Location of the alias file. For example, a Google Cloud Storage URI." } } }, "GoogleCloudApigeeV1Export": { "id": "GoogleCloudApigeeV1Export", "properties": { "name": { "description": "Display name of the export job.", "type": "string" }, "error": { "readOnly": true, "description": "Output only. Error is set when export fails", "type": "string" }, "created": { "description": "Output only. Time the export job was created.", "type": "string", "readOnly": true }, "executionTime": { "description": "Output only. Execution time for this export job. If the job is still in progress, it will be set to the amount of time that has elapsed since`created`, in seconds. Else, it will set to (`updated` - `created`), in seconds.", "readOnly": true, "type": "string" }, "datastoreName": { "type": "string", "description": "Name of the datastore that is the destination of the export job [datastore]" }, "description": { "type": "string", "description": "Description of the export job." }, "self": { "readOnly": true, "description": "Output only. Self link of the export job. A URI that can be used to retrieve the status of an export job. Example: `/organizations/myorg/environments/myenv/analytics/exports/9cfc0d85-0f30-46d6-ae6f-318d0cb961bd`", "type": "string" }, "state": { "type": "string", "readOnly": true, "description": "Output only. Status of the export job. Valid values include `enqueued`, `running`, `completed`, and `failed`." }, "updated": { "type": "string", "description": "Output only. Time the export job was last updated.", "readOnly": true } }, "type": "object", "description": "Details of an export job." }, "GoogleCloudApigeeV1ListSharedFlowsResponse": { "id": "GoogleCloudApigeeV1ListSharedFlowsResponse", "description": "To change this message, in the same CL add a change log in go/changing-api-proto-breaks-ui", "properties": { "sharedFlows": { "type": "array", "items": { "$ref": "GoogleCloudApigeeV1SharedFlow" } } }, "type": "object" }, "GoogleCloudApigeeV1OrganizationProjectMapping": { "properties": { "projectId": { "description": "Google Cloud project associated with the Apigee organization", "type": "string" }, "projectIds": { "type": "array", "deprecated": true, "description": "DEPRECATED: Use `project_id`. An Apigee Organization is mapped to a single project.", "items": { "type": "string" } }, "location": { "readOnly": true, "type": "string", "description": "Output only. The Google Cloud region where control plane data is located. For more information, see https://cloud.google.com/about/locations/." }, "organization": { "description": "Name of the Apigee organization.", "type": "string" } }, "id": "GoogleCloudApigeeV1OrganizationProjectMapping", "type": "object" }, "GoogleCloudApigeeV1ListAppGroupsResponse": { "id": "GoogleCloudApigeeV1ListAppGroupsResponse", "description": "ListAppGroupsResponse contains the 0 or more AppGroups, along with the optional page token and the total count of apps.", "type": "object", "properties": { "nextPageToken": { "description": "Token that can be sent as `next_page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, "appGroups": { "items": { "$ref": "GoogleCloudApigeeV1AppGroup" }, "type": "array", "description": "List of AppGroups." }, "totalSize": { "type": "integer", "description": "Total count of AppGroups.", "format": "int32" } } }, "GoogleCloudApigeeV1SecurityAssessmentResultScoringResult": { "description": "The result of the assessment.", "properties": { "score": { "type": "integer", "format": "int32", "description": "The security score of the assessment." }, "severity": { "description": "The severity of the assessment.", "type": "string", "enumDescriptions": [ "Severity is not defined.", "Severity is low.", "Severity is medium.", "Severity is high.", "Severity is minimal" ], "enum": [ "SEVERITY_UNSPECIFIED", "LOW", "MEDIUM", "HIGH", "MINIMAL" ] }, "assessmentRecommendations": { "description": "The recommendations of the assessment. The key is the \"name\" of the assessment (not display_name), and the value are the recommendations.", "additionalProperties": { "$ref": "GoogleCloudApigeeV1SecurityAssessmentResultScoringResultAssessmentRecommendation" }, "type": "object" }, "dataUpdateTime": { "format": "google-datetime", "description": "The time when resource data was last fetched for this resource. This time may be different than when the resource was actually updated due to lag in data collection.", "type": "string" }, "failedAssessmentPerWeight": { "type": "object", "description": "The number of failed assessments grouped by its weight. Keys are one of the following: \"MAJOR\", \"MODERATE\", \"MINOR\".", "additionalProperties": { "format": "int32", "type": "integer" } } }, "type": "object", "id": "GoogleCloudApigeeV1SecurityAssessmentResultScoringResult" }, "GoogleCloudApigeeV1QueryTimeSeriesStatsResponse": { "type": "object", "properties": { "columns": { "type": "array", "description": "Column names corresponding to the same order as the inner values in the stats field.", "items": { "type": "string" } }, "values": { "items": { "$ref": "GoogleCloudApigeeV1QueryTimeSeriesStatsResponseSequence" }, "description": "Results of the query returned as a JSON array.", "type": "array" }, "nextPageToken": { "type": "string", "description": "Next page token." } }, "id": "GoogleCloudApigeeV1QueryTimeSeriesStatsResponse", "description": "Represents security stats result as a collection of time series sequences." }, "GoogleCloudApigeeV1SchemaSchemaProperty": { "properties": { "createTime": { "type": "string", "description": "Time the field was created in RFC3339 string form. For example: `2016-02-26T10:23:09.592Z`." }, "custom": { "type": "string", "description": "Flag that specifies whether the field is standard in the dataset or a custom field created by the customer. `true` indicates that it is a custom field." }, "type": { "type": "string", "description": "Data type of the field." } }, "id": "GoogleCloudApigeeV1SchemaSchemaProperty", "description": "Properties for the schema field.", "type": "object" }, "GoogleCloudApigeeV1DeveloperMonetizationConfig": { "description": "Monetization configuration for the developer.", "properties": { "billingType": { "enum": [ "BILLING_TYPE_UNSPECIFIED", "PREPAID", "POSTPAID" ], "description": "Billing type.", "type": "string", "enumDescriptions": [ "The default/unset value.", "Developer pays in advance for the use of APIs and the charged amount is deducted from their account balance.", "Developer does not maintain an account balance. The API provider bills the developer for API usage." ] } }, "id": "GoogleCloudApigeeV1DeveloperMonetizationConfig", "type": "object" }, "GoogleCloudApigeeV1SecurityActionAllow": { "properties": {}, "description": "Message that should be set in case of an Allow Action. This does not have any fields.", "id": "GoogleCloudApigeeV1SecurityActionAllow", "type": "object" }, "GoogleCloudApigeeV1ListDatastoresResponse": { "properties": { "datastores": { "description": "A list of datastores", "items": { "$ref": "GoogleCloudApigeeV1Datastore" }, "type": "array" } }, "type": "object", "id": "GoogleCloudApigeeV1ListDatastoresResponse", "description": "The response for ListDatastores" }, "GoogleCloudApigeeV1DeveloperSubscription": { "properties": { "createdAt": { "readOnly": true, "type": "string", "description": "Output only. Time when the API product subscription was created in milliseconds since epoch.", "format": "int64" }, "endTime": { "description": "Time when the API product subscription ends in milliseconds since epoch.", "format": "int64", "type": "string" }, "name": { "description": "Output only. Name of the API product subscription.", "type": "string", "readOnly": true }, "lastModifiedAt": { "format": "int64", "readOnly": true, "type": "string", "description": "Output only. Time when the API product subscription was last modified in milliseconds since epoch." }, "startTime": { "type": "string", "format": "int64", "description": "Time when the API product subscription starts in milliseconds since epoch." }, "apiproduct": { "description": "Name of the API product for which the developer is purchasing a subscription.", "type": "string" } }, "id": "GoogleCloudApigeeV1DeveloperSubscription", "description": "Structure of a DeveloperSubscription.", "type": "object" }, "GoogleCloudApigeeV1ListSecurityReportsResponse": { "id": "GoogleCloudApigeeV1ListSecurityReportsResponse", "type": "object", "properties": { "securityReports": { "items": { "$ref": "GoogleCloudApigeeV1SecurityReport" }, "description": "The security reports belong to requested resource name.", "type": "array" }, "nextPageToken": { "type": "string", "description": "If the number of security reports exceeded the page size requested, the token can be used to fetch the next page in a subsequent call. If the response is the last page and there are no more reports to return this field is left empty." } }, "description": "The response for SecurityReports." }, "GoogleTypeInterval": { "id": "GoogleTypeInterval", "properties": { "endTime": { "format": "google-datetime", "type": "string", "description": "Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end." }, "startTime": { "type": "string", "format": "google-datetime", "description": "Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start." } }, "type": "object", "description": "Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time." }, "GoogleCloudApigeeV1DatastoreConfig": { "description": "Configuration detail for datastore", "type": "object", "id": "GoogleCloudApigeeV1DatastoreConfig", "properties": { "bucketName": { "description": "Name of the Cloud Storage bucket. Required for `gcs` target_type.", "type": "string" }, "datasetName": { "type": "string", "description": "BigQuery dataset name Required for `bigquery` target_type." }, "tablePrefix": { "type": "string", "description": "Prefix of BigQuery table Required for `bigquery` target_type." }, "projectId": { "description": "Required. GCP project in which the datastore exists", "type": "string" }, "path": { "type": "string", "description": "Path of Cloud Storage bucket Required for `gcs` target_type." } } }, "GoogleCloudApigeeV1ReferenceConfig": { "id": "GoogleCloudApigeeV1ReferenceConfig", "properties": { "name": { "description": "Name of the reference in the following format: `organizations/{org}/environments/{env}/references/{reference}`", "type": "string" }, "resourceName": { "type": "string", "description": "Name of the referenced resource in the following format: `organizations/{org}/environments/{env}/keystores/{keystore}` Only references to keystore resources are supported." } }, "type": "object" }, "GoogleCloudApigeeV1DeploymentGroupConfig": { "description": "DeploymentGroupConfig represents a deployment group that should be present in a particular environment.", "type": "object", "properties": { "deploymentGroupType": { "enum": [ "DEPLOYMENT_GROUP_TYPE_UNSPECIFIED", "STANDARD", "EXTENSIBLE" ], "description": "Type of the deployment group, which will be either Standard or Extensible.", "type": "string", "enumDescriptions": [ "Unspecified type", "Standard type", "Extensible Type" ] }, "name": { "type": "string", "description": "Name of the deployment group in the following format: `organizations/{org}/environments/{env}/deploymentGroups/{group}`." }, "revisionId": { "type": "string", "description": "Revision number which can be used by the runtime to detect if the deployment group has changed between two versions.", "format": "int64" }, "uid": { "type": "string", "description": "Unique ID. The ID will only change if the deployment group is deleted and recreated." } }, "id": "GoogleCloudApigeeV1DeploymentGroupConfig" }, "GoogleCloudApigeeV1ProfileConfigThreat": { "properties": {}, "type": "object", "id": "GoogleCloudApigeeV1ProfileConfigThreat", "description": "By default, following policies will be included: - XMLThreatProtection - JSONThreatProtection" }, "GoogleCloudApigeeV1SecurityAction": { "description": "A SecurityAction is rule that can be enforced at an environment level. The result is one of: - A denied API call - An explicitly allowed API call - A flagged API call (HTTP headers added before the target receives it) At least one condition is required to create a SecurityAction.", "id": "GoogleCloudApigeeV1SecurityAction", "type": "object", "properties": { "updateTime": { "description": "Output only. The update time for this SecurityAction. This reflects when this SecurityAction changed states.", "readOnly": true, "type": "string", "format": "google-datetime" }, "description": { "description": "Optional. An optional user provided description of the SecurityAction.", "type": "string" }, "conditionConfig": { "$ref": "GoogleCloudApigeeV1SecurityActionConditionConfig", "description": "Required. A valid SecurityAction must contain at least one condition." }, "ttl": { "type": "string", "format": "google-duration", "description": "Input only. The TTL for this SecurityAction." }, "state": { "description": "Required. Only an ENABLED SecurityAction is enforced. An ENABLED SecurityAction past its expiration time will not be enforced.", "enum": [ "STATE_UNSPECIFIED", "ENABLED", "DISABLED" ], "type": "string", "enumDescriptions": [ "The default value. This only exists for forward compatibility. A create request with this value will be rejected.", "An ENABLED SecurityAction is actively enforced if the `expiration_time` is in the future.", "A disabled SecurityAction is never enforced." ] }, "name": { "description": "Immutable. This field is ignored during creation as per AIP-133. Please set the `security_action_id` field in the CreateSecurityActionRequest when creating a new SecurityAction. Format: organizations/{org}/environments/{env}/securityActions/{security_action}", "type": "string" }, "deny": { "$ref": "GoogleCloudApigeeV1SecurityActionDeny", "description": "Deny a request through if it matches this SecurityAction." }, "expireTime": { "format": "google-datetime", "type": "string", "description": "The expiration for this SecurityAction." }, "flag": { "$ref": "GoogleCloudApigeeV1SecurityActionFlag", "description": "Flag a request through if it matches this SecurityAction." }, "createTime": { "readOnly": true, "description": "Output only. The create time for this SecurityAction.", "format": "google-datetime", "type": "string" }, "allow": { "$ref": "GoogleCloudApigeeV1SecurityActionAllow", "description": "Allow a request through if it matches this SecurityAction." } } }, "GoogleCloudApigeeV1Result": { "id": "GoogleCloudApigeeV1Result", "description": "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", "type": "object", "properties": { "content": { "description": "Error message content. for example, \"content\" : \"{\\\"fault\\\":{\\\"faultstring\\\":\\\"API timed out\\\",\\\"detail\\\":{\\\"errorcode\\\":\\\"flow.APITimedOut\\\"}}}\"", "type": "string" }, "statusCode": { "type": "string", "description": "HTTP response code" }, "verb": { "type": "string", "description": "HTTP method verb" }, "accessList": { "items": { "$ref": "GoogleCloudApigeeV1Access" }, "type": "array", "description": "A list of variable access actions agaist the api proxy. Supported values: Get, Set, Remove." }, "timestamp": { "type": "string", "description": "Timestamp of when the result is recorded. Its format is dd-mm-yy hh:mm:ss:xxx. For example, `\"timestamp\" : \"12-08-19 00:31:59:960\"`" }, "properties": { "description": "Name value pairs used for DebugInfo ActionResult.", "$ref": "GoogleCloudApigeeV1Properties" }, "reasonPhrase": { "description": "HTTP response phrase", "type": "string" }, "uRI": { "description": "The relative path of the api proxy. for example, `\"uRI\" : \"/iloveapis\"`", "type": "string" }, "headers": { "type": "array", "description": "A list of HTTP headers. for example, '\"headers\" : [ { \"name\" : \"Content-Length\", \"value\" : \"83\" }, { \"name\" : \"Content-Type\", \"value\" : \"application/json\" } ]'", "items": { "$ref": "GoogleCloudApigeeV1Property" } }, "ActionResult": { "description": "Type of the action result. Can be one of the five: DebugInfo, RequestMessage, ResponseMessage, ErrorMessage, VariableAccess", "type": "string" } } }, "GoogleCloudApigeeV1ListOrganizationsResponse": { "type": "object", "id": "GoogleCloudApigeeV1ListOrganizationsResponse", "properties": { "organizations": { "items": { "$ref": "GoogleCloudApigeeV1OrganizationProjectMapping" }, "type": "array", "description": "List of Apigee organizations and associated Google Cloud projects." } } }, "GoogleCloudApigeeV1KeyValueEntry": { "type": "object", "properties": { "name": { "description": "Resource URI that can be used to identify the scope of the key value map entries.", "type": "string" }, "value": { "type": "string", "description": "Required. Data or payload that is being retrieved and associated with the unique key." } }, "id": "GoogleCloudApigeeV1KeyValueEntry", "description": "Key value map pair where the value represents the data associated with the corresponding key. **Note**: Supported for Apigee hybrid 1.8.x and higher." }, "GoogleCloudApigeeV1DataCollector": { "id": "GoogleCloudApigeeV1DataCollector", "description": "Data collector configuration.", "properties": { "type": { "enumDescriptions": [ "For future compatibility.", "For integer values.", "For float values.", "For string values.", "For boolean values.", "For datetime values." ], "enum": [ "TYPE_UNSPECIFIED", "INTEGER", "FLOAT", "STRING", "BOOLEAN", "DATETIME" ], "type": "string", "description": "Immutable. The type of data this data collector will collect." }, "description": { "type": "string", "description": "A description of the data collector." }, "name": { "type": "string", "description": "ID of the data collector. Must begin with `dc_`." }, "lastModifiedAt": { "format": "int64", "description": "Output only. The time at which the Data Collector was last updated in milliseconds since the epoch.", "type": "string", "readOnly": true }, "createdAt": { "format": "int64", "type": "string", "description": "Output only. The time at which the data collector was created in milliseconds since the epoch.", "readOnly": true } }, "type": "object" }, "GoogleCloudApigeeV1Deployment": { "properties": { "instances": { "items": { "$ref": "GoogleCloudApigeeV1InstanceDeploymentStatus" }, "description": "Status reported by each runtime instance. **Note**: This field is displayed only when viewing deployment status.", "type": "array" }, "pods": { "type": "array", "description": "Status reported by runtime pods. **Note**: **This field is deprecated**. Runtime versions 1.3 and above report instance level status rather than pod status.", "items": { "$ref": "GoogleCloudApigeeV1PodStatus" } }, "deployStartTime": { "type": "string", "description": "Time the API proxy was marked `deployed` in the control plane in millisconds since epoch.", "format": "int64" }, "proxyDeploymentType": { "type": "string", "description": "Output only. The type of the deployment (standard or extensible) Deployed proxy revision will be marked as extensible in following 2 cases. 1. The deployed proxy revision uses extensible policies. 2. If a environment supports flowhooks and flow hook is configured.", "enumDescriptions": [ "Default value till public preview. After public preview this value should not be returned.", "Deployment will be of type Standard if only Standard proxies are used", "Proxy will be of type Extensible if deployments uses one or more Extensible proxies" ], "readOnly": true, "enum": [ "PROXY_DEPLOYMENT_TYPE_UNSPECIFIED", "STANDARD", "EXTENSIBLE" ] }, "revision": { "description": "API proxy revision.", "type": "string" }, "apiProxy": { "type": "string", "description": "API proxy." }, "serviceAccount": { "description": "The full resource name of Cloud IAM Service Account that this deployment is using, eg, `projects/-/serviceAccounts/{email}`.", "type": "string" }, "errors": { "description": "Errors reported for this deployment. Populated only when state == ERROR. **Note**: This field is displayed only when viewing deployment status.", "items": { "$ref": "GoogleRpcStatus" }, "type": "array" }, "routeConflicts": { "description": "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 deployment's base paths 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. **Note**: This field is displayed only when viewing deployment status.", "items": { "$ref": "GoogleCloudApigeeV1DeploymentChangeReportRoutingConflict" }, "type": "array" }, "environment": { "type": "string", "description": "Environment." }, "state": { "description": "Current state of the deployment. **Note**: This field is displayed only when viewing deployment status.", "enum": [ "RUNTIME_STATE_UNSPECIFIED", "READY", "PROGRESSING", "ERROR" ], "type": "string", "enumDescriptions": [ "This value should never be returned.", "Runtime has loaded the deployment.", "Deployment is not fully ready in the runtime.", "Encountered an error with the deployment that requires intervention." ] } }, "id": "GoogleCloudApigeeV1Deployment", "type": "object" }, "GoogleCloudApigeeV1SetAddonEnablementRequest": { "properties": { "analyticsEnabled": { "description": "If the Analytics should be enabled in the environment.", "type": "boolean" }, "apiSecurityEnabled": { "type": "boolean", "description": "If the API Security should be enabled in the environment." } }, "description": "Request for SetAddonEnablement.", "id": "GoogleCloudApigeeV1SetAddonEnablementRequest", "type": "object" }, "GoogleCloudApigeeV1TraceSamplingConfig": { "type": "object", "id": "GoogleCloudApigeeV1TraceSamplingConfig", "description": "TraceSamplingConfig 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.", "properties": { "samplingRate": { "format": "float", "description": "Field sampling rate. This value is only applicable when using the PROBABILITY sampler. The supported values are \u003e 0 and \u003c= 0.5.", "type": "number" }, "sampler": { "enumDescriptions": [ "Sampler unspecified.", "OFF means distributed trace is disabled, or the sampling probability is 0.", "PROBABILITY means traces are captured on a probability that defined by sampling_rate. The sampling rate is limited to 0 to 0.5 when this is set." ], "enum": [ "SAMPLER_UNSPECIFIED", "OFF", "PROBABILITY" ], "type": "string", "description": "Sampler of distributed tracing. OFF is the default value." } } }, "GoogleCloudApigeeV1ListSecurityProfilesResponse": { "description": "Response for ListSecurityProfiles.", "id": "GoogleCloudApigeeV1ListSecurityProfilesResponse", "properties": { "securityProfiles": { "items": { "$ref": "GoogleCloudApigeeV1SecurityProfile" }, "description": "List of security profiles in the organization. The profiles may be attached or unattached to any environment. This will return latest revision of each profile.", "type": "array" }, "nextPageToken": { "type": "string", "description": "A token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages." } }, "type": "object" }, "GoogleCloudApigeeV1Properties": { "properties": { "property": { "description": "List of all properties in the object", "items": { "$ref": "GoogleCloudApigeeV1Property" }, "type": "array" } }, "description": "Message for compatibility with legacy Edge specification for Java Properties object in JSON.", "type": "object", "id": "GoogleCloudApigeeV1Properties" }, "GoogleCloudApigeeV1OperationGroup": { "id": "GoogleCloudApigeeV1OperationGroup", "description": "List of operation configuration details associated with Apigee API proxies or remote services. Remote services are non-Apigee proxies, such as Istio-Envoy.", "properties": { "operationConfigType": { "description": "Flag that specifes whether the configuration is for Apigee API proxy or a remote service. Valid values include `proxy` or `remoteservice`. Defaults to `proxy`. Set to `proxy` when Apigee API proxies are associated with the API product. Set to `remoteservice` when non-Apigee proxies like Istio-Envoy are associated with the API product.", "type": "string" }, "operationConfigs": { "description": "Required. List of operation configurations for either Apigee API proxies or other remote services that are associated with this API product.", "items": { "$ref": "GoogleCloudApigeeV1OperationConfig" }, "type": "array" } }, "type": "object" }, "GoogleCloudApigeeV1SecurityActionConditionConfig": { "description": "The following are a list of conditions. A valid SecurityAction must contain at least one condition. Within a condition, each element is ORed. Across conditions elements are ANDed. For example if a SecurityAction has the following: ip_address_ranges: [\"ip1\", \"ip2\"] and bot_reasons: [\"Flooder\", \"Robot Abuser\"] then this is interpreted as: enforce the action if the incoming request has ((ip_address_ranges = \"ip1\" OR ip_address_ranges = \"ip2\") AND (bot_reasons=\"Flooder\" OR bot_reasons=\"Robot Abuser\")). Conditions other than ip_address_ranges and bot_reasons cannot be ANDed.", "id": "GoogleCloudApigeeV1SecurityActionConditionConfig", "type": "object", "properties": { "userAgents": { "items": { "type": "string" }, "type": "array", "description": "Optional. A list of user agents to deny. We look for exact matches. Limit 50 per action." }, "regionCodes": { "items": { "type": "string" }, "description": "Optional. A list of countries/region codes to act on, e.g. US. This follows https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2.", "type": "array" }, "botReasons": { "type": "array", "description": "Optional. A list of Bot Reasons. Current options: Flooder, Brute Guessor, Static Content Scraper, OAuth Abuser, Robot Abuser, TorListRule, Advanced Anomaly Detection, Advanced API Scraper, Search Engine Crawlers, Public Clouds, Public Cloud AWS, Public Cloud Azure, and Public Cloud Google.", "items": { "type": "string" } }, "accessTokens": { "items": { "type": "string" }, "description": "Optional. A list of access_tokens. Limit 1000 per action.", "type": "array" }, "developers": { "items": { "type": "string" }, "type": "array", "description": "Optional. A list of developers. Limit 1000 per action." }, "developerApps": { "type": "array", "items": { "type": "string" }, "description": "Optional. A list of developer apps. Limit 1000 per action." }, "asns": { "description": "Optional. A list of ASN numbers to act on, e.g. 23. https://en.wikipedia.org/wiki/Autonomous_system_(Internet) This uses int64 instead of uint32 because of https://linter.aip.dev/141/forbidden-types.", "type": "array", "items": { "format": "int64", "type": "string" } }, "ipAddressRanges": { "type": "array", "items": { "type": "string" }, "description": "Optional. A list of IP addresses. This could be either IPv4 or IPv6. Limited to 100 per action." }, "httpMethods": { "type": "array", "description": "Optional. Act only on particular HTTP methods. E.g. A read-only API can block POST/PUT/DELETE methods. Accepted values are: GET, HEAD, POST, PUT, DELETE, CONNECT, OPTIONS, TRACE and PATCH.", "items": { "type": "string" } }, "apiKeys": { "items": { "type": "string" }, "description": "Optional. A list of API keys. Limit 1000 per action.", "type": "array" }, "apiProducts": { "items": { "type": "string" }, "type": "array", "description": "Optional. A list of API Products. Limit 1000 per action." } } }, "GoogleCloudApigeeV1ResourceFiles": { "type": "object", "properties": { "resourceFile": { "type": "array", "description": "List of resource files.", "items": { "$ref": "GoogleCloudApigeeV1ResourceFile" } } }, "id": "GoogleCloudApigeeV1ResourceFiles", "description": "List of resource files." }, "GoogleCloudApigeeV1SecurityAssessmentResultResource": { "description": "Resource for which we are computing security assessment.", "id": "GoogleCloudApigeeV1SecurityAssessmentResultResource", "type": "object", "properties": { "name": { "description": "Required. Name of this resource.", "type": "string" }, "type": { "type": "string", "description": "Required. Type of this resource.", "enumDescriptions": [ "ResourceType not specified.", "Resource is an Apigee Proxy." ], "enum": [ "RESOURCE_TYPE_UNSPECIFIED", "API_PROXY" ] }, "resourceRevisionId": { "type": "string", "description": "The revision id for the resource. In case of Apigee, this is proxy revision id." } } }, "GoogleCloudApigeeV1DeveloperBalanceWallet": { "description": "Wallet used to manage an account balance for a particular currency.", "type": "object", "properties": { "balance": { "$ref": "GoogleTypeMoney", "description": "Current remaining balance of the developer for a particular currency." }, "lastCreditTime": { "description": "Output only. Time at which the developer last added credit to the account in milliseconds since epoch.", "type": "string", "readOnly": true, "format": "int64" } }, "id": "GoogleCloudApigeeV1DeveloperBalanceWallet" }, "GoogleCloudApigeeV1RuntimeAddonsConfig": { "description": "RuntimeAddonsConfig defines the runtime configurations for add-ons in an environment.", "id": "GoogleCloudApigeeV1RuntimeAddonsConfig", "type": "object", "properties": { "name": { "type": "string", "description": "Name of the addons config in the format: `organizations/{org}/environments/{env}/addonsConfig`" }, "revisionId": { "type": "string", "description": "Revision number used by the runtime to detect config changes." }, "apiSecurityConfig": { "description": "Runtime configuration for API Security add-on.", "$ref": "GoogleCloudApigeeV1RuntimeApiSecurityConfig" }, "uid": { "description": "UID is to detect if config is recreated after deletion. The add-on config will only be deleted when the environment itself gets deleted, thus it will always be the same as the UID of EnvironmentConfig.", "type": "string" }, "analyticsConfig": { "$ref": "GoogleCloudApigeeV1RuntimeAnalyticsConfig", "description": "Runtime configuration for Analytics add-on." } } }, "GoogleCloudApigeeV1DeveloperApp": { "type": "object", "id": "GoogleCloudApigeeV1DeveloperApp", "properties": { "lastModifiedAt": { "readOnly": true, "type": "string", "description": "Output only. Time the developer app was modified in milliseconds since epoch.", "format": "int64" }, "developerId": { "type": "string", "description": "ID of the developer." }, "credentials": { "type": "array", "items": { "$ref": "GoogleCloudApigeeV1Credential" }, "readOnly": true, "description": "Output only. Set of credentials for the developer app consisting of the consumer key/secret pairs associated with the API products." }, "apiProducts": { "items": { "type": "string" }, "description": "List of API products associated with the developer app.", "type": "array" }, "scopes": { "description": "Scopes to apply to the developer app. The specified scopes must already exist for the API product that you associate with the developer app.", "items": { "type": "string" }, "type": "array" }, "appFamily": { "description": "Developer app family.", "type": "string" }, "attributes": { "items": { "$ref": "GoogleCloudApigeeV1Attribute" }, "description": "List of attributes for the developer app.", "type": "array" }, "callbackUrl": { "description": "Callback URL used by OAuth 2.0 authorization servers to communicate authorization codes back to developer apps.", "type": "string" }, "keyExpiresIn": { "format": "int64", "type": "string", "description": "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." }, "createdAt": { "readOnly": true, "description": "Output only. Time the developer app was created in milliseconds since epoch.", "type": "string", "format": "int64" }, "appId": { "type": "string", "description": "ID of the developer app." }, "name": { "type": "string", "description": "Name of the developer app." }, "status": { "type": "string", "description": "Status of the credential. Valid values include `approved` or `revoked`." } } }, "GoogleCloudApigeeV1SecurityReport": { "id": "GoogleCloudApigeeV1SecurityReport", "type": "object", "properties": { "result": { "description": "Result is available only after the query is completed.", "$ref": "GoogleCloudApigeeV1SecurityReportResultMetadata" }, "resultRows": { "format": "int64", "description": "ResultRows is available only after the query is completed.", "type": "string" }, "created": { "description": "Creation time of the query.", "type": "string" }, "error": { "type": "string", "description": "Error is set when query fails." }, "displayName": { "description": "Display Name specified by the user.", "type": "string" }, "updated": { "readOnly": true, "description": "Output only. Last updated timestamp for the query.", "type": "string" }, "resultFileSize": { "description": "ResultFileSize is available only after the query is completed.", "type": "string" }, "envgroupHostname": { "type": "string", "description": "Hostname is available only when query is executed at host level." }, "reportDefinitionId": { "type": "string", "description": "Report Definition ID." }, "executionTime": { "description": "ExecutionTime is available only after the query is completed.", "type": "string" }, "self": { "description": "Self link of the query. Example: `/organizations/myorg/environments/myenv/securityReports/9cfc0d85-0f30-46d6-ae6f-318d0cb961bd` or following format if query is running at host level: `/organizations/myorg/hostSecurityReports/9cfc0d85-0f30-46d6-ae6f-318d0cb961bd`", "type": "string" }, "queryParams": { "description": "Contains information like metrics, dimenstions etc of the Security Report.", "$ref": "GoogleCloudApigeeV1SecurityReportMetadata" }, "state": { "description": "Query state could be \"enqueued\", \"running\", \"completed\", \"expired\" and \"failed\".", "type": "string" } }, "description": "SecurityReport saves all the information about the created security report." }, "GoogleCloudApigeeV1DateRange": { "description": "Date range of the data to export.", "properties": { "start": { "type": "string", "description": "Required. Start date of the data to export in the format `yyyy-mm-dd`. The date range begins at 00:00:00 UTC on the start date." }, "end": { "type": "string", "description": "Required. End date (exclusive) of the data to export in the format `yyyy-mm-dd`. The date range ends at 00:00:00 UTC on the end date- which will not be in the output." } }, "id": "GoogleCloudApigeeV1DateRange", "type": "object" }, "GoogleCloudApigeeV1RatePlan": { "properties": { "fixedFeeFrequency": { "format": "int32", "description": "Frequency at which the fixed fee is charged.", "type": "integer" }, "lastModifiedAt": { "format": "int64", "type": "string", "readOnly": true, "description": "Output only. Time the rate plan was last modified in milliseconds since epoch." }, "apiproduct": { "type": "string", "description": "Name of the API product that the rate plan is associated with." }, "setupFee": { "description": "Initial, one-time fee paid when purchasing the API product.", "$ref": "GoogleTypeMoney" }, "fixedRecurringFee": { "description": "Fixed amount that is charged at a defined interval and billed in advance of use of the API product. The fee will be prorated for the first billing period.", "$ref": "GoogleTypeMoney" }, "name": { "description": "Output only. Name of the rate plan.", "readOnly": true, "type": "string" }, "description": { "type": "string", "description": "Description of the rate plan." }, "revenueShareType": { "enumDescriptions": [ "Revenue share type is not specified.", "Fixed percentage of the total revenue will be shared. The percentage to be shared can be configured by the API provider.", "Amount of revenue shared depends on the number of API calls. The API call volume ranges and the revenue share percentage for each volume can be configured by the API provider. **Note**: Not supported by Apigee at this time." ], "type": "string", "description": "Method used to calculate the revenue that is shared with developers.", "enum": [ "REVENUE_SHARE_TYPE_UNSPECIFIED", "FIXED", "VOLUME_BANDED" ] }, "consumptionPricingType": { "enum": [ "CONSUMPTION_PRICING_TYPE_UNSPECIFIED", "FIXED_PER_UNIT", "BANDED", "TIERED", "STAIRSTEP" ], "type": "string", "description": "Pricing model used for consumption-based charges.", "enumDescriptions": [ "Pricing model not specified. This is the default.", "Fixed rate charged for each API call.", "Variable rate charged for each API call based on price tiers. Example: * 1-100 calls cost $2 per call * 101-200 calls cost $1.50 per call * 201-300 calls cost $1 per call * Total price for 50 calls: 50 x $2 = $100 * Total price for 150 calls: 100 x $2 + 50 x $1.5 = $275 * Total price for 250 calls: 100 x $2 + 100 x $1.5 + 50 x $1 = $400. **Note**: Not supported by Apigee at this time.", "**Note**: Not supported by Apigee at this time.", "**Note**: Not supported by Apigee at this time." ] }, "displayName": { "description": "Display name of the rate plan.", "type": "string" }, "endTime": { "format": "int64", "description": "Time when the rate plan will expire in milliseconds since epoch. Set to 0 or `null` to indicate that the rate plan should never expire.", "type": "string" }, "state": { "enum": [ "STATE_UNSPECIFIED", "DRAFT", "PUBLISHED" ], "enumDescriptions": [ "State of the rate plan is not specified.", "Rate plan is in draft mode and only visible to API providers.", "Rate plan is published and will become visible to developers for the configured duration (between `startTime` and `endTime`)." ], "description": "Current state of the rate plan (draft or published).", "type": "string" }, "startTime": { "description": "Time when the rate plan becomes active in milliseconds since epoch.", "format": "int64", "type": "string" }, "createdAt": { "readOnly": true, "format": "int64", "description": "Output only. Time that the rate plan was created in milliseconds since epoch.", "type": "string" }, "consumptionPricingRates": { "type": "array", "description": "API call volume ranges and the fees charged when the total number of API calls is within a given range. The method used to calculate the final fee depends on the selected pricing model. For example, if the pricing model is `STAIRSTEP` and the ranges are defined as follows: ``` { \"start\": 1, \"end\": 100, \"fee\": 75 }, { \"start\": 101, \"end\": 200, \"fee\": 100 }, } ``` Then the following fees would be charged based on the total number of API calls (assuming the currency selected is `USD`): * 1 call costs $75 * 50 calls cost $75 * 150 calls cost $100 The number of API calls cannot exceed 200.", "items": { "$ref": "GoogleCloudApigeeV1RateRange" } }, "paymentFundingModel": { "deprecated": true, "enumDescriptions": [ "Billing account type not specified.", "Prepaid billing account type. Developer pays in advance for the use of your API products. Funds are deducted from their prepaid account balance. **Note**: Not supported by Apigee at this time.", "Postpaid billing account type. Developer is billed through an invoice after using your API products." ], "type": "string", "description": "DEPRECATED: This field is no longer supported and will eventually be removed when Apigee Hybrid 1.5/1.6 is no longer supported. Instead, use the `billingType` field inside `DeveloperMonetizationConfig` resource. Flag that specifies the billing account type, prepaid or postpaid.", "enum": [ "PAYMENT_FUNDING_MODEL_UNSPECIFIED", "PREPAID", "POSTPAID" ] }, "revenueShareRates": { "type": "array", "description": "Details of the revenue sharing model.", "items": { "$ref": "GoogleCloudApigeeV1RevenueShareRange" } }, "currencyCode": { "description": "Currency to be used for billing. Consists of a three-letter code as defined by the [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) standard.", "type": "string" }, "billingPeriod": { "enum": [ "BILLING_PERIOD_UNSPECIFIED", "WEEKLY", "MONTHLY" ], "description": "Frequency at which the customer will be billed.", "enumDescriptions": [ "Billing period not specified.", "Weekly billing period. **Note**: Not supported by Apigee at this time.", "Monthly billing period." ], "type": "string" } }, "description": "Rate plan details.", "id": "GoogleCloudApigeeV1RatePlan", "type": "object" }, "GoogleCloudApigeeV1GraphQLOperation": { "id": "GoogleCloudApigeeV1GraphQLOperation", "properties": { "operation": { "description": "GraphQL operation name. The name and operation type will be used to apply quotas. If no name is specified, the quota will be applied to all GraphQL operations irrespective of their operation names in the payload.", "type": "string" }, "operationTypes": { "items": { "type": "string" }, "type": "array", "description": "Required. GraphQL operation types. Valid values include `query` or `mutation`. **Note**: Apigee does not currently support `subscription` types." } }, "type": "object", "description": "Represents the pairing of GraphQL operation types and the GraphQL operation name." }, "GoogleCloudApigeeV1GetAsyncQueryResultUrlResponse": { "properties": { "urls": { "type": "array", "items": { "$ref": "GoogleCloudApigeeV1GetAsyncQueryResultUrlResponseURLInfo" }, "description": "The list of Signed URLs generated by the CreateAsyncQuery request" } }, "id": "GoogleCloudApigeeV1GetAsyncQueryResultUrlResponse", "type": "object", "description": "The response for GetAsyncQueryResultUrl" }, "GoogleCloudApigeeV1KeyAliasReference": { "type": "object", "properties": { "reference": { "description": "Reference name in the following format: `organizations/{org}/environments/{env}/references/{reference}`", "type": "string" }, "aliasId": { "type": "string", "description": "Alias ID. Must exist in the keystore referred to by the reference." } }, "id": "GoogleCloudApigeeV1KeyAliasReference" }, "GoogleCloudApigeeV1SecurityReportResultView": { "properties": { "error": { "type": "string", "description": "Error message when there is a failure." }, "metadata": { "$ref": "GoogleCloudApigeeV1SecurityReportMetadata", "description": "Metadata contains information like metrics, dimenstions etc of the security report." }, "state": { "description": "State of retrieving ResultView.", "type": "string" }, "rows": { "type": "array", "description": "Rows of security report result. Each row is a JSON object. Example: {sum(message_count): 1, developer_app: \"(not set)\",…}", "items": { "type": "any" } }, "code": { "description": "Error code when there is a failure.", "format": "int32", "type": "integer" } }, "id": "GoogleCloudApigeeV1SecurityReportResultView", "type": "object", "description": "The response for security report result view APIs." }, "GoogleCloudApigeeV1ListArchiveDeploymentsResponse": { "type": "object", "id": "GoogleCloudApigeeV1ListArchiveDeploymentsResponse", "description": "Response for ListArchiveDeployments method.", "properties": { "archiveDeployments": { "description": "Archive Deployments in the specified environment.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1ArchiveDeployment" } }, "nextPageToken": { "type": "string", "description": "Page token that you can include in a ListArchiveDeployments request to retrieve the next page. If omitted, no subsequent pages exist." } } }, "GoogleCloudApigeeV1EnableSecurityActionRequest": { "type": "object", "id": "GoogleCloudApigeeV1EnableSecurityActionRequest", "description": "Message to enable a disabled SecurityAction.", "properties": {} }, "GoogleCloudApigeeV1ListEnvironmentGroupsResponse": { "description": "Response for ListEnvironmentGroups.", "type": "object", "id": "GoogleCloudApigeeV1ListEnvironmentGroupsResponse", "properties": { "environmentGroups": { "description": "EnvironmentGroups in the specified organization.", "items": { "$ref": "GoogleCloudApigeeV1EnvironmentGroup" }, "type": "array" }, "nextPageToken": { "description": "Page token that you can include in a ListEnvironmentGroups request to retrieve the next page. If omitted, no subsequent pages exist.", "type": "string" } } }, "GoogleCloudApigeeV1DeploymentConfig": { "description": "NEXT ID: 11", "type": "object", "properties": { "endpoints": { "additionalProperties": { "type": "string" }, "type": "object", "description": "A mapping from basepaths to proxy endpoint names in this proxy. Not populated for shared flows." }, "uid": { "type": "string", "description": "Unique ID. The ID will only change if the deployment is deleted and recreated." }, "attributes": { "description": "Additional key-value metadata for the deployment.", "additionalProperties": { "type": "string" }, "type": "object" }, "serviceAccount": { "type": "string", "description": "The service account identity associated with this deployment. If non-empty, will be in the following format: `projects/-/serviceAccounts/{account_email}`" }, "name": { "type": "string", "description": "Name of the API or shared flow revision to be deployed in the following format: `organizations/{org}/apis/{api}/revisions/{rev}` or `organizations/{org}/sharedflows/{sharedflow}/revisions/{rev}`" }, "deploymentGroups": { "description": "The list of deployment groups in which this proxy should be deployed. Not currently populated for shared flows.", "items": { "type": "string" }, "type": "array" }, "proxyUid": { "description": "Unique ID of the API proxy revision.", "type": "string" }, "basePath": { "type": "string", "description": "Base path where the application will be hosted. Defaults to \"/\"." }, "location": { "description": "Location of the API proxy bundle as a URI.", "type": "string" } }, "id": "GoogleCloudApigeeV1DeploymentConfig" }, "GoogleCloudApigeeV1CustomReport": { "properties": { "properties": { "type": "array", "items": { "$ref": "GoogleCloudApigeeV1ReportProperty" }, "description": "This field contains report properties such as ui metadata etc." }, "fromTime": { "description": "Legacy field: not used. Contains the from time for the report", "type": "string" }, "limit": { "description": "Legacy field: not used This field contains the limit for the result retrieved", "type": "string" }, "lastViewedAt": { "format": "int64", "readOnly": true, "description": "Output only. Last viewed time of this entity as milliseconds since epoch", "type": "string" }, "metrics": { "description": "Required. This contains the list of metrics", "items": { "$ref": "GoogleCloudApigeeV1CustomReportMetric" }, "type": "array" }, "organization": { "type": "string", "readOnly": true, "description": "Output only. Organization name" }, "name": { "description": "Required. Unique identifier for the report T his is a legacy field used to encode custom report unique id", "type": "string" }, "chartType": { "type": "string", "description": "This field contains the chart type for the report" }, "tags": { "items": { "type": "string" }, "type": "array", "description": "Legacy field: not used. This field contains a list of tags associated with custom report" }, "timeUnit": { "description": "This field contains the time unit of aggregation for the report", "type": "string" }, "lastModifiedAt": { "format": "int64", "type": "string", "description": "Output only. Modified time of this entity as milliseconds since epoch. json key: lastModifiedAt", "readOnly": true }, "sortOrder": { "description": "Legacy field: not used much. Contains the sort order for the sort columns", "type": "string" }, "toTime": { "type": "string", "description": "Legacy field: not used. Contains the end time for the report" }, "dimensions": { "type": "array", "items": { "type": "string" }, "description": "This contains the list of dimensions for the report" }, "filter": { "type": "string", "description": "This field contains the filter expression" }, "comments": { "description": "Legacy field: not used. This field contains a list of comments associated with custom report", "items": { "type": "string" }, "type": "array" }, "sortByCols": { "items": { "type": "string" }, "type": "array", "description": "Legacy field: not used much. Contains the list of sort by columns" }, "environment": { "description": "Output only. Environment name", "readOnly": true, "type": "string" }, "createdAt": { "readOnly": true, "description": "Output only. Unix time when the app was created json key: createdAt", "type": "string", "format": "int64" }, "topk": { "description": "Legacy field: not used. This field contains the top k parameter value for restricting the result", "type": "string" }, "offset": { "description": "Legacy field: not used. This field contains the offset for the data", "type": "string" }, "displayName": { "type": "string", "description": "This is the display name for the report" } }, "id": "GoogleCloudApigeeV1CustomReport", "type": "object" }, "GoogleCloudApigeeV1OperationConfig": { "type": "object", "description": "Binds the resources in an API proxy or remote service with the allowed REST methods and associated quota enforcement.", "properties": { "attributes": { "description": "Custom attributes associated with the operation.", "items": { "$ref": "GoogleCloudApigeeV1Attribute" }, "type": "array" }, "apiSource": { "description": "Required. Name of the API proxy or remote service with which the resources, methods, and quota are associated.", "type": "string" }, "operations": { "description": "List of resource/method pairs for the API proxy or remote service to which quota will applied. **Note**: Currently, you can specify only a single resource/method pair. The call will fail if more than one resource/method pair is provided.", "items": { "$ref": "GoogleCloudApigeeV1Operation" }, "type": "array" }, "quota": { "$ref": "GoogleCloudApigeeV1Quota", "description": "Quota parameters to be enforced for the resources, methods, and API source combination. If none are specified, quota enforcement will not be done." } }, "id": "GoogleCloudApigeeV1OperationConfig" }, "GoogleCloudApigeeV1UpdateAppGroupAppKeyRequest": { "type": "object", "description": "Request for UpdateAppGroupAppKey", "id": "GoogleCloudApigeeV1UpdateAppGroupAppKeyRequest", "properties": { "appGroupAppKey": { "$ref": "GoogleCloudApigeeV1AppGroupAppKey", "description": "The new AppGroupKey to be amended. Note that the status can be updated only via action." }, "apiProducts": { "type": "array", "description": "The list of API products that will be associated with the credential. This list will be appended to the existing list of associated API Products for this App Key. Duplicates will be ignored.", "items": { "type": "string" } }, "action": { "type": "string", "description": "Approve or revoke the consumer key by setting this value to `approve` or `revoke` respectively. The `Content-Type` header, if set, must be set to `application/octet-stream`, with empty body." } } }, "GoogleCloudApigeeV1Stats": { "type": "object", "properties": { "hosts": { "items": { "$ref": "GoogleCloudApigeeV1StatsHostStats" }, "description": "List of query results grouped by host.", "type": "array" }, "environments": { "type": "array", "items": { "$ref": "GoogleCloudApigeeV1StatsEnvironmentStats" }, "description": "List of query results on the environment level." }, "metaData": { "$ref": "GoogleCloudApigeeV1Metadata", "description": "Metadata information." } }, "id": "GoogleCloudApigeeV1Stats", "description": "Encapsulates a `stats` response." }, "GoogleCloudApigeeV1TestDatastoreResponse": { "type": "object", "properties": { "error": { "readOnly": true, "description": "Output only. Error message of test connection failure", "type": "string" }, "state": { "readOnly": true, "type": "string", "description": "Output only. It could be `completed` or `failed`" } }, "description": "The response for TestDatastore", "id": "GoogleCloudApigeeV1TestDatastoreResponse" }, "GoogleIamV1AuditConfig": { "type": "object", "properties": { "service": { "description": "Specifies a service that will be enabled for audit logging. For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special value that covers all services.", "type": "string" }, "auditLogConfigs": { "type": "array", "description": "The configuration for logging of each type of permission.", "items": { "$ref": "GoogleIamV1AuditLogConfig" } } }, "description": "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.", "id": "GoogleIamV1AuditConfig" }, "GoogleCloudApigeeV1DataCollectorConfig": { "description": "Data collector and its configuration.", "type": "object", "properties": { "name": { "description": "Name of the data collector in the following format: `organizations/{org}/datacollectors/{datacollector}`", "type": "string" }, "type": { "enumDescriptions": [ "For future compatibility.", "For integer values.", "For float values.", "For string values.", "For boolean values.", "For datetime values." ], "type": "string", "enum": [ "TYPE_UNSPECIFIED", "INTEGER", "FLOAT", "STRING", "BOOLEAN", "DATETIME" ], "description": "Data type accepted by the data collector." } }, "id": "GoogleCloudApigeeV1DataCollectorConfig" }, "GoogleCloudApigeeV1ConnectorsPlatformConfig": { "type": "object", "description": "Configuration for the Connectors Platform add-on.", "id": "GoogleCloudApigeeV1ConnectorsPlatformConfig", "properties": { "expiresAt": { "description": "Output only. Time at which the Connectors Platform add-on expires in milliseconds since epoch. If unspecified, the add-on will never expire.", "type": "string", "readOnly": true, "format": "int64" }, "enabled": { "type": "boolean", "description": "Flag that specifies whether the Connectors Platform add-on is enabled." } } }, "GoogleCloudApigeeV1Datastore": { "id": "GoogleCloudApigeeV1Datastore", "description": "The data store defines the connection to export data repository (Cloud Storage, BigQuery), including the credentials used to access the data repository.", "type": "object", "properties": { "createTime": { "readOnly": true, "description": "Output only. Datastore create time, in milliseconds since the epoch of 1970-01-01T00:00:00Z", "format": "int64", "type": "string" }, "self": { "readOnly": true, "description": "Output only. Resource link of Datastore. Example: `/organizations/{org}/analytics/datastores/{uuid}`", "type": "string" }, "datastoreConfig": { "description": "Datastore Configurations.", "$ref": "GoogleCloudApigeeV1DatastoreConfig" }, "org": { "type": "string", "readOnly": true, "description": "Output only. Organization that the datastore belongs to" }, "displayName": { "description": "Required. Display name in UI", "type": "string" }, "targetType": { "type": "string", "description": "Destination storage type. Supported types `gcs` or `bigquery`." }, "lastUpdateTime": { "description": "Output only. Datastore last update time, in milliseconds since the epoch of 1970-01-01T00:00:00Z", "readOnly": true, "type": "string", "format": "int64" } } }, "GoogleCloudApigeeV1ApiDocDocumentation": { "description": "The documentation for a catalog item.", "type": "object", "id": "GoogleCloudApigeeV1ApiDocDocumentation", "properties": { "graphqlDocumentation": { "$ref": "GoogleCloudApigeeV1GraphqlDocumentation", "description": "Optional. GraphQL documentation." }, "oasDocumentation": { "$ref": "GoogleCloudApigeeV1OASDocumentation", "description": "Optional. OpenAPI Specification documentation." } } }, "GoogleCloudApigeeV1RateRange": { "description": "API call volume range and the fees charged when the total number of API calls is within the range.", "properties": { "fee": { "$ref": "GoogleTypeMoney", "description": "Fee to charge when total number of API calls falls within this range." }, "end": { "type": "string", "description": "Ending value of the range. Set to 0 or `null` for the last range of values.", "format": "int64" }, "start": { "type": "string", "format": "int64", "description": "Starting value of the range. Set to 0 or `null` for the initial range of values." } }, "type": "object", "id": "GoogleCloudApigeeV1RateRange" }, "GoogleCloudApigeeV1QueryTabularStatsRequest": { "id": "GoogleCloudApigeeV1QueryTabularStatsRequest", "description": "Request payload representing the query to be run for fetching security statistics as rows.", "type": "object", "properties": { "dimensions": { "type": "array", "description": "Required. List of dimension names to group the aggregations by.", "items": { "type": "string" } }, "metrics": { "items": { "$ref": "GoogleCloudApigeeV1MetricAggregation" }, "description": "Required. List of metrics and their aggregations.", "type": "array" }, "timeRange": { "description": "Time range for the stats.", "$ref": "GoogleTypeInterval" }, "pageSize": { "description": "Page size represents the number of rows.", "format": "int32", "type": "integer" }, "pageToken": { "type": "string", "description": "Identifies a sequence of rows." }, "filter": { "description": "Filter further on specific dimension values. Follows the same grammar as custom report's filter expressions. Example, apiproxy eq 'foobar'. https://cloud.google.com/apigee/docs/api-platform/analytics/analytics-reference#filters", "type": "string" } } }, "GoogleCloudApigeeV1TargetServerConfig": { "id": "GoogleCloudApigeeV1TargetServerConfig", "type": "object", "properties": { "port": { "type": "integer", "description": "Port number for the target server.", "format": "int32" }, "protocol": { "description": "The protocol used by this target server.", "enumDescriptions": [ "UNSPECIFIED defaults to HTTP for backwards compatibility.", "The TargetServer uses HTTP.", "The TargetSever uses HTTP2.", "The TargetServer uses GRPC.", "GRPC TargetServer to be used in ExternalCallout Policy. Prefer to use EXTERNAL_CALLOUT instead. TODO(b/266125112) deprecate once EXTERNAL _CALLOUT generally available.", "The TargetServer is to be used in the ExternalCallout Policy" ], "type": "string", "enum": [ "PROTOCOL_UNSPECIFIED", "HTTP", "HTTP2", "GRPC_TARGET", "GRPC", "EXTERNAL_CALLOUT" ] }, "name": { "description": "Target server revision name in the following format: `organizations/{org}/environments/{env}/targetservers/{targetserver}/revisions/{rev}`", "type": "string" }, "enabled": { "type": "boolean", "description": "Whether the target server is enabled. An empty/omitted value for this field should be interpreted as true." }, "tlsInfo": { "$ref": "GoogleCloudApigeeV1TlsInfoConfig", "description": "TLS settings for the target server." }, "host": { "type": "string", "description": "Host name of the target server." } } }, "GoogleProtobufEmpty": { "properties": {}, "id": "GoogleProtobufEmpty", "type": "object", "description": "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); }" }, "GoogleCloudApigeeV1EnvironmentGroup": { "type": "object", "properties": { "name": { "type": "string", "description": "ID of the environment group." }, "hostnames": { "type": "array", "description": "Required. Host names for this environment group.", "items": { "type": "string" } }, "createdAt": { "format": "int64", "description": "Output only. The time at which the environment group was created as milliseconds since epoch.", "readOnly": true, "type": "string" }, "state": { "enumDescriptions": [ "Resource is in an unspecified state.", "Resource is being created.", "Resource is provisioned and ready to use.", "The resource is being deleted.", "The resource is being updated." ], "type": "string", "description": "Output only. State of the environment group. Values other than ACTIVE means the resource is not ready to use.", "enum": [ "STATE_UNSPECIFIED", "CREATING", "ACTIVE", "DELETING", "UPDATING" ], "readOnly": true }, "lastModifiedAt": { "readOnly": true, "type": "string", "description": "Output only. The time at which the environment group was last updated as milliseconds since epoch.", "format": "int64" } }, "id": "GoogleCloudApigeeV1EnvironmentGroup", "description": "EnvironmentGroup configuration. An environment group is used to group one or more Apigee environments under a single host name." }, "GoogleLongrunningListOperationsResponse": { "properties": { "nextPageToken": { "type": "string", "description": "The standard List next-page token." }, "operations": { "items": { "$ref": "GoogleLongrunningOperation" }, "description": "A list of operations that matches the specified filter in the request.", "type": "array" } }, "description": "The response message for Operations.ListOperations.", "id": "GoogleLongrunningListOperationsResponse", "type": "object" }, "GoogleCloudApigeeV1Keystore": { "id": "GoogleCloudApigeeV1Keystore", "type": "object", "properties": { "aliases": { "readOnly": true, "type": "array", "items": { "type": "string" }, "description": "Output only. Aliases in this keystore." }, "name": { "type": "string", "description": "Required. Resource ID for this keystore. Values must match the regular expression `[\\w[:space:].-]{1,255}`." } }, "description": "Datastore for Certificates and Aliases." }, "GoogleRpcPreconditionFailure": { "description": "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.", "id": "GoogleRpcPreconditionFailure", "properties": { "violations": { "type": "array", "description": "Describes all precondition violations.", "items": { "$ref": "GoogleRpcPreconditionFailureViolation" } } }, "type": "object" }, "GoogleCloudApigeeV1StatsEnvironmentStats": { "description": "Encapsulates the environment wrapper: ``` \"environments\": [ { \"metrics\": [ { \"name\": \"sum(message_count)\", \"values\": [ \"2.52056245E8\" ] } ], \"name\": \"prod\" } ]```", "id": "GoogleCloudApigeeV1StatsEnvironmentStats", "type": "object", "properties": { "dimensions": { "description": "List of metrics grouped under dimensions.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1DimensionMetric" } }, "metrics": { "type": "array", "items": { "$ref": "GoogleCloudApigeeV1Metric" }, "description": "In the final response, only one of the following fields will be present based on the dimensions provided. If no dimensions are provided, then only top-level metrics is provided. If dimensions are included, then there will be a top-level dimensions field under environments which will contain metrics values and the dimension name. Example: ``` \"environments\": [ { \"dimensions\": [ { \"metrics\": [ { \"name\": \"sum(message_count)\", \"values\": [ \"2.14049521E8\" ] } ], \"name\": \"nit_proxy\" } ], \"name\": \"prod\" } ]``` or ```\"environments\": [ { \"metrics\": [ { \"name\": \"sum(message_count)\", \"values\": [ \"2.19026331E8\" ] } ], \"name\": \"prod\" } ]``` List of metric values." }, "name": { "type": "string", "description": "Name of the environment." } } }, "GoogleCloudApigeeV1TraceConfigOverride": { "id": "GoogleCloudApigeeV1TraceConfigOverride", "type": "object", "properties": { "samplingConfig": { "$ref": "GoogleCloudApigeeV1TraceSamplingConfig", "description": "Trace configuration to override." }, "apiProxy": { "type": "string", "description": "ID of the API proxy that will have its trace configuration overridden." }, "name": { "type": "string", "description": "ID of the trace configuration override specified as a system-generated UUID." } }, "description": "A representation of a configuration override." }, "GoogleCloudApigeeV1RuntimeConfig": { "id": "GoogleCloudApigeeV1RuntimeConfig", "description": "Runtime configuration for the organization. Response for GetRuntimeConfig.", "type": "object", "properties": { "name": { "type": "string", "description": "Name of the resource in the following format: `organizations/{org}/runtimeConfig`." }, "tenantProjectId": { "type": "string", "description": "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.", "readOnly": true }, "analyticsBucket": { "description": "Cloud Storage bucket used for uploading Analytics records.", "type": "string" }, "traceBucket": { "type": "string", "description": "Cloud Storage bucket used for uploading Trace records." } } }, "GoogleCloudApigeeV1ListAppGroupAppsResponse": { "id": "GoogleCloudApigeeV1ListAppGroupAppsResponse", "description": "Response for ListAppGroupApps", "properties": { "nextPageToken": { "description": "Token that can be sent as `next_page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, "appGroupApps": { "type": "array", "items": { "$ref": "GoogleCloudApigeeV1AppGroupApp" }, "description": "List of AppGroup apps and their credentials." } }, "type": "object" }, "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestIncludeAll": { "type": "object", "description": "Message for include_all option.", "properties": {}, "id": "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestIncludeAll" }, "GoogleCloudApigeeV1Credential": { "id": "GoogleCloudApigeeV1Credential", "properties": { "consumerSecret": { "type": "string", "description": "Secret key." }, "expiresAt": { "description": "Time the credential will expire in milliseconds since epoch.", "type": "string", "format": "int64" }, "apiProducts": { "items": { "$ref": "GoogleCloudApigeeV1ApiProductRef" }, "description": "List of API products this credential can be used for.", "type": "array" }, "consumerKey": { "type": "string", "description": "Consumer key." }, "scopes": { "description": "List of scopes to apply to the app. Specified scopes must already exist on the API product that you associate with the app.", "type": "array", "items": { "type": "string" } }, "attributes": { "items": { "$ref": "GoogleCloudApigeeV1Attribute" }, "description": "List of attributes associated with this credential.", "type": "array" }, "issuedAt": { "description": "Time the credential was issued in milliseconds since epoch.", "type": "string", "format": "int64" }, "status": { "type": "string", "description": "Status of the credential. Valid values include `approved` or `revoked`." } }, "type": "object" }, "GoogleCloudApigeeV1GrpcOperationGroup": { "id": "GoogleCloudApigeeV1GrpcOperationGroup", "description": "List of gRPC operation configuration details associated with Apigee API proxies.", "properties": { "operationConfigs": { "description": "Required. List of operation configurations for either Apigee API proxies that are associated with this API product.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1GrpcOperationConfig" } } }, "type": "object" }, "GoogleCloudApigeeV1Operation": { "properties": { "methods": { "items": { "type": "string" }, "description": "methods refers to the REST verbs as in https://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html. When none specified, all verb types are allowed.", "type": "array" }, "resource": { "description": "Required. REST resource path associated with the API proxy or remote service.", "type": "string" } }, "description": "Represents the pairing of REST resource path and the actions (verbs) allowed on the resource path.", "type": "object", "id": "GoogleCloudApigeeV1Operation" }, "GoogleCloudApigeeV1SecurityReportResultMetadata": { "id": "GoogleCloudApigeeV1SecurityReportResultMetadata", "properties": { "expires": { "description": "Output only. Expire_time is set to 7 days after report creation. Query result will be unaccessable after this time. Example: \"2021-05-04T13:38:52-07:00\"", "readOnly": true, "type": "string" }, "self": { "type": "string", "description": "Self link of the query results. Example: `/organizations/myorg/environments/myenv/securityReports/9cfc0d85-0f30-46d6-ae6f-318d0cb961bd/result` or following format if query is running at host level: `/organizations/myorg/hostSecurityReports/9cfc0d85-0f30-46d6-ae6f-318d0cb961bd/result`" } }, "description": "Contains informations about the security report results.", "type": "object" }, "GoogleCloudApigeeV1ListEndpointAttachmentsResponse": { "id": "GoogleCloudApigeeV1ListEndpointAttachmentsResponse", "properties": { "nextPageToken": { "description": "Page token that you can include in an `ListEndpointAttachments` request to retrieve the next page. If omitted, no subsequent pages exist.", "type": "string" }, "endpointAttachments": { "type": "array", "items": { "$ref": "GoogleCloudApigeeV1EndpointAttachment" }, "description": "Endpoint attachments in the specified organization." } }, "description": "Response for ListEndpointAttachments method.", "type": "object" }, "GoogleCloudApigeeV1QueryMetric": { "id": "GoogleCloudApigeeV1QueryMetric", "properties": { "function": { "description": "Aggregation function: avg, min, max, or sum.", "type": "string" }, "operator": { "description": "One of `+`, `-`, `/`, `%`, `*`.", "type": "string" }, "alias": { "type": "string", "description": "Alias for the metric. Alias will be used to replace metric name in query results." }, "value": { "type": "string", "description": "Operand value should be provided when operator is set." }, "name": { "type": "string", "description": "Required. Metric name." } }, "type": "object", "description": "More info about Metric: https://docs.apigee.com/api-platform/analytics/analytics-reference#metrics" }, "GoogleCloudApigeeV1FlowHookConfig": { "properties": { "name": { "type": "string", "description": "Name of the flow hook in the following format: `organizations/{org}/environments/{env}/flowhooks/{point}`. Valid `point` values include: `PreProxyFlowHook`, `PostProxyFlowHook`, `PreTargetFlowHook`, and `PostTargetFlowHook`" }, "continueOnError": { "description": "Flag that specifies whether the flow should abort after an error in the flow hook. Defaults to `true` (continue on error).", "type": "boolean" }, "sharedFlowName": { "description": "Name of the shared flow to invoke in the following format: `organizations/{org}/sharedflows/{sharedflow}`", "type": "string" } }, "type": "object", "id": "GoogleCloudApigeeV1FlowHookConfig" }, "GoogleCloudApigeeV1StatsHostStats": { "description": "Encapsulates the hostname wrapper: ``` \"hosts\": [ { \"metrics\": [ { \"name\": \"sum(message_count)\", \"values\": [ \"2.52056245E8\" ] } ], \"name\": \"example.com\" } ]```", "id": "GoogleCloudApigeeV1StatsHostStats", "properties": { "dimensions": { "items": { "$ref": "GoogleCloudApigeeV1DimensionMetric" }, "type": "array", "description": "List of metrics grouped under dimensions." }, "name": { "type": "string", "description": "Hostname used in query." }, "metrics": { "type": "array", "items": { "$ref": "GoogleCloudApigeeV1Metric" }, "description": "In the final response, only one of the following fields will be present based on the dimensions provided. If no dimensions are provided, then only the top-level metrics are provided. If dimensions are included, then there will be a top-level dimensions field under hostnames which will contain metrics values and the dimension name. Example: ``` \"hosts\": [ { \"dimensions\": [ { \"metrics\": [ { \"name\": \"sum(message_count)\", \"values\": [ \"2.14049521E8\" ] } ], \"name\": \"nit_proxy\" } ], \"name\": \"example.com\" } ]``` OR ```\"hosts\": [ { \"metrics\": [ { \"name\": \"sum(message_count)\", \"values\": [ \"2.19026331E8\" ] } ], \"name\": \"example.com\" } ]``` List of metric values." } }, "type": "object" }, "GoogleCloudApigeeV1AppGroup": { "type": "object", "properties": { "organization": { "type": "string", "description": "Immutable. the org the app group is created" }, "appGroupId": { "readOnly": true, "type": "string", "description": "Output only. Internal identifier that cannot be edited" }, "channelId": { "type": "string", "description": "channel identifier identifies the owner maintaing this grouping." }, "lastModifiedAt": { "type": "string", "format": "int64", "readOnly": true, "description": "Output only. Modified time as milliseconds since epoch." }, "displayName": { "description": "app group name displayed in the UI", "type": "string" }, "channelUri": { "description": "A reference to the associated storefront/marketplace.", "type": "string" }, "attributes": { "type": "array", "description": "A list of attributes", "items": { "$ref": "GoogleCloudApigeeV1Attribute" } }, "createdAt": { "format": "int64", "type": "string", "description": "Output only. Created time as milliseconds since epoch.", "readOnly": true }, "name": { "description": "Immutable. Name of the AppGroup. Characters you can use in the name are restricted to: A-Z0-9._\\-$ %.", "type": "string" }, "status": { "description": "Valid values are `active` or `inactive`. Note that the status of the AppGroup should be updated via UpdateAppGroupRequest by setting the action as `active` or `inactive`.", "type": "string" } }, "description": "AppGroup contains the request/response fields representing the logical grouping of apps. Note that appgroup_id, create_time and update_time cannot be changed by the user, and gets updated by the system. The name and the organization once provided cannot be edited subsequently.", "id": "GoogleCloudApigeeV1AppGroup" }, "GoogleCloudApigeeV1DeploymentChangeReportRoutingConflict": { "type": "object", "description": "Describes a routing conflict that may cause a deployment not to receive traffic at some base path.", "id": "GoogleCloudApigeeV1DeploymentChangeReportRoutingConflict", "properties": { "conflictingDeployment": { "description": "Existing base path/deployment causing the conflict.", "$ref": "GoogleCloudApigeeV1DeploymentChangeReportRoutingDeployment" }, "environmentGroup": { "description": "Name of the environment group in which this conflict exists.", "type": "string" }, "description": { "description": "Human-readable description of this conflict.", "type": "string" } } }, "GoogleCloudApigeeV1EndpointChainingRule": { "id": "GoogleCloudApigeeV1EndpointChainingRule", "properties": { "deploymentGroup": { "description": "The deployment group to target for cross-shard chaining calls to these proxies.", "type": "string" }, "proxyIds": { "type": "array", "items": { "type": "string" }, "description": "List of proxy ids which may be found in the given deployment group." } }, "type": "object", "description": "EndpointChainingRule specifies the proxies contained in a particular deployment group, so that other deployment groups can find them in chaining calls." }, "GoogleCloudApigeeV1Organization": { "type": "object", "id": "GoogleCloudApigeeV1Organization", "properties": { "description": { "type": "string", "description": "Description of the Apigee organization." }, "createdAt": { "format": "int64", "description": "Output only. Time that the Apigee organization was created in milliseconds since epoch.", "readOnly": true, "type": "string" }, "analyticsRegion": { "type": "string", "deprecated": true, "description": "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](https://cloud.google.com/apigee/docs/api-platform/get-started/create-org)." }, "projectId": { "type": "string", "readOnly": true, "description": "Output only. Project ID associated with the Apigee organization." }, "authorizedNetwork": { "description": "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.", "type": "string" }, "state": { "enum": [ "STATE_UNSPECIFIED", "CREATING", "ACTIVE", "DELETING", "UPDATING" ], "description": "Output only. State of the organization. Values other than ACTIVE means the resource is not ready to use.", "enumDescriptions": [ "Resource is in an unspecified state.", "Resource is being created.", "Resource is provisioned and ready to use.", "The resource is being deleted.", "The resource is being updated." ], "readOnly": true, "type": "string" }, "disableVpcPeering": { "type": "boolean", "description": "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." }, "expiresAt": { "readOnly": true, "format": "int64", "description": "Output only. Time that the Apigee organization is scheduled for deletion.", "type": "string" }, "customerName": { "type": "string", "description": "Not used by Apigee." }, "billingType": { "type": "string", "enumDescriptions": [ "Billing type not specified.", "A pre-paid subscription to Apigee.", "Free and limited access to Apigee for evaluation purposes only.", "Access to Apigee using a Pay-As-You-Go plan." ], "description": "Billing type of the Apigee organization. See [Apigee pricing](https://cloud.google.com/apigee/pricing).", "enum": [ "BILLING_TYPE_UNSPECIFIED", "SUBSCRIPTION", "EVALUATION", "PAYG" ] }, "attributes": { "items": { "type": "string" }, "description": "Not used by Apigee.", "type": "array" }, "runtimeDatabaseEncryptionKeyName": { "type": "string", "description": "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. If not specified or [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." }, "portalDisabled": { "type": "boolean", "description": "Configuration for the Portals settings." }, "subscriptionPlan": { "enumDescriptions": [ "Subscription plan not specified.", "Traditional subscription plan.", "New subscription plan that provides standard proxy and scaled proxy implementation." ], "enum": [ "SUBSCRIPTION_PLAN_UNSPECIFIED", "SUBSCRIPTION_2021", "SUBSCRIPTION_2024" ], "readOnly": true, "type": "string", "description": "Output only. Subscription plan that the customer has purchased. Output only." }, "addonsConfig": { "$ref": "GoogleCloudApigeeV1AddonsConfig", "description": "Addon configurations of the Apigee organization." }, "displayName": { "type": "string", "description": "Display name for the Apigee organization. Unused, but reserved for future use." }, "type": { "description": "Not used by Apigee.", "enum": [ "TYPE_UNSPECIFIED", "TYPE_TRIAL", "TYPE_PAID", "TYPE_INTERNAL" ], "type": "string", "enumDescriptions": [ "Subscription type not specified.", "Subscription to Apigee is free, limited, and used for evaluation purposes only.", "Full subscription to Apigee has been purchased. See [Apigee pricing](https://cloud.google.com/apigee/pricing/).", "For internal users only." ] }, "properties": { "$ref": "GoogleCloudApigeeV1Properties", "description": "Properties defined in the Apigee organization profile." }, "name": { "readOnly": true, "description": "Output only. Name of the Apigee organization.", "type": "string" }, "apigeeProjectId": { "description": "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.", "readOnly": true, "type": "string" }, "apiConsumerDataEncryptionKeyName": { "type": "string", "description": "Cloud KMS key name used for encrypting API consumer data. If not specified or [BillingType](#BillingType) is `EVALUATION`, a Google-Managed encryption key will be used. Format: `projects/*/locations/*/keyRings/*/cryptoKeys/*`" }, "lastModifiedAt": { "description": "Output only. Time that the Apigee organization was last modified in milliseconds since epoch.", "readOnly": true, "format": "int64", "type": "string" }, "apiConsumerDataLocation": { "type": "string", "description": "This field is needed only for customers using non-default data residency regions. 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." }, "caCertificate": { "description": "Output only. Base64-encoded public certificate for the root CA of the Apigee organization. Valid only when [RuntimeType](#RuntimeType) is `CLOUD`.", "readOnly": true, "type": "string", "format": "byte" }, "runtimeType": { "enum": [ "RUNTIME_TYPE_UNSPECIFIED", "CLOUD", "HYBRID" ], "enumDescriptions": [ "Runtime type not specified.", "Google-managed Apigee runtime.", "User-managed Apigee hybrid runtime." ], "description": "Required. Runtime type of the Apigee organization based on the Apigee subscription purchased.", "type": "string" }, "controlPlaneEncryptionKeyName": { "type": "string", "description": "Cloud KMS key name used for encrypting control plane data that is stored in a multi region. Only used for the data residency region \"US\" or \"EU\". If not specified or [BillingType](#BillingType) is `EVALUATION`, a Google-Managed encryption key will be used. Format: `projects/*/locations/*/keyRings/*/cryptoKeys/*`" }, "environments": { "readOnly": true, "items": { "type": "string" }, "description": "Output only. List of environments in the Apigee organization.", "type": "array" }, "subscriptionType": { "enum": [ "SUBSCRIPTION_TYPE_UNSPECIFIED", "PAID", "TRIAL" ], "description": "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/).", "enumDescriptions": [ "Subscription type not specified.", "Full subscription to Apigee has been purchased.", "Subscription to Apigee is free, limited, and used for evaluation purposes only." ], "readOnly": true, "deprecated": true, "type": "string" } } }, "GoogleCloudApigeeV1ListEnvironmentResourcesResponse": { "type": "object", "description": "Response for ListEnvironmentResources", "id": "GoogleCloudApigeeV1ListEnvironmentResourcesResponse", "properties": { "resourceFile": { "type": "array", "items": { "$ref": "GoogleCloudApigeeV1ResourceFile" }, "description": "List of resources files." } } }, "GoogleCloudApigeeV1GraphqlDocumentation": { "type": "object", "id": "GoogleCloudApigeeV1GraphqlDocumentation", "description": "GraphQL documentation for a catalog item.", "properties": { "schema": { "$ref": "GoogleCloudApigeeV1DocumentationFile", "description": "Required. The documentation file contents for the GraphQL schema." }, "endpointUri": { "type": "string", "description": "Required. The GraphQL endpoint URI to be queried by API consumers. Max length is 2,083 characters." } } }, "GoogleCloudApigeeV1QueryTimeSeriesStatsRequest": { "description": "QueryTimeSeriesStatsRequest represents a query that returns a collection of time series sequences grouped by their values.", "type": "object", "id": "GoogleCloudApigeeV1QueryTimeSeriesStatsRequest", "properties": { "timestampOrder": { "enumDescriptions": [ "Unspecified order. Default is Descending.", "Ascending sort order.", "Descending sort order." ], "description": "Order the sequences in increasing or decreasing order of timestamps. Default is descending order of timestamps (latest first).", "enum": [ "ORDER_UNSPECIFIED", "ASCENDING", "DESCENDING" ], "type": "string" }, "dimensions": { "description": "List of dimension names to group the aggregations by. If no dimensions are passed, a single trend line representing the requested metric aggregations grouped by environment is returned.", "items": { "type": "string" }, "type": "array" }, "filter": { "description": "Filter further on specific dimension values. Follows the same grammar as custom report's filter expressions. Example, apiproxy eq 'foobar'. https://cloud.google.com/apigee/docs/api-platform/analytics/analytics-reference#filters", "type": "string" }, "pageToken": { "type": "string", "description": "Page token stands for a specific collection of time series sequences." }, "pageSize": { "format": "int32", "description": "Page size represents the number of time series sequences, one per unique set of dimensions and their values.", "type": "integer" }, "timeRange": { "$ref": "GoogleTypeInterval", "description": "Required. Time range for the stats." }, "windowSize": { "enumDescriptions": [ "Unspecified window size. Default is 1 hour.", "1 Minute window", "1 Hour window", "1 Day window", "1 Month window" ], "type": "string", "enum": [ "WINDOW_SIZE_UNSPECIFIED", "MINUTE", "HOUR", "DAY", "MONTH" ], "description": "Time buckets to group the stats by." }, "metrics": { "type": "array", "items": { "$ref": "GoogleCloudApigeeV1MetricAggregation" }, "description": "Required. List of metrics and their aggregations." } } }, "GoogleCloudApigeeV1GraphQLOperationGroup": { "type": "object", "id": "GoogleCloudApigeeV1GraphQLOperationGroup", "description": "List of graphQL operation configuration details associated with Apigee API proxies or remote services. Remote services are non-Apigee proxies, such as Istio-Envoy.", "properties": { "operationConfigs": { "items": { "$ref": "GoogleCloudApigeeV1GraphQLOperationConfig" }, "type": "array", "description": "Required. List of operation configurations for either Apigee API proxies or other remote services that are associated with this API product." }, "operationConfigType": { "type": "string", "description": "Flag that specifies whether the configuration is for Apigee API proxy or a remote service. Valid values include `proxy` or `remoteservice`. Defaults to `proxy`. Set to `proxy` when Apigee API proxies are associated with the API product. Set to `remoteservice` when non-Apigee proxies like Istio-Envoy are associated with the API product." } } }, "GoogleCloudApigeeV1DeveloperBalance": { "id": "GoogleCloudApigeeV1DeveloperBalance", "description": "Account balance for the developer.", "properties": { "wallets": { "type": "array", "items": { "$ref": "GoogleCloudApigeeV1DeveloperBalanceWallet" }, "readOnly": true, "description": "Output only. List of all wallets. Each individual wallet stores the account balance for a particular currency." } }, "type": "object" }, "GoogleCloudApigeeV1AsyncQueryResult": { "type": "object", "properties": { "expires": { "description": "Query result will be unaccessable after this time.", "type": "string" }, "self": { "type": "string", "description": "Self link of the query results. Example: `/organizations/myorg/environments/myenv/queries/9cfc0d85-0f30-46d6-ae6f-318d0cb961bd/result` or following format if query is running at host level: `/organizations/myorg/hostQueries/9cfc0d85-0f30-46d6-ae6f-318d0cb961bd/result`" } }, "id": "GoogleCloudApigeeV1AsyncQueryResult" }, "GoogleCloudApigeeV1SharedFlowRevision": { "id": "GoogleCloudApigeeV1SharedFlowRevision", "properties": { "resourceFiles": { "$ref": "GoogleCloudApigeeV1ResourceFiles", "description": "The resource files included in this shared flow revision." }, "sharedFlows": { "description": "A list of the shared flow names included in this shared flow revision.", "items": { "type": "string" }, "type": "array" }, "policies": { "description": "A list of policy names included in this shared flow revision.", "type": "array", "items": { "type": "string" } }, "contextInfo": { "type": "string", "description": "A textual description of the shared flow revision." }, "createdAt": { "type": "string", "description": "Time at which this shared flow revision was created, in milliseconds since epoch.", "format": "int64" }, "type": { "type": "string", "description": "The string \"Application\"" }, "configurationVersion": { "$ref": "GoogleCloudApigeeV1ConfigVersion", "description": "The version of the configuration schema to which this shared flow conforms. The only supported value currently is majorVersion 4 and minorVersion 0. This setting may be used in the future to enable evolution of the shared flow format." }, "displayName": { "type": "string", "description": "The human readable name of this shared flow." }, "name": { "type": "string", "description": "The resource ID of the parent shared flow." }, "resources": { "type": "array", "description": "A list of the resources included in this shared flow revision formatted as \"{type}://{name}\".", "items": { "type": "string" } }, "revision": { "description": "The resource ID of this revision.", "type": "string" }, "entityMetaDataAsProperties": { "additionalProperties": { "type": "string" }, "description": "A Key-Value map of metadata about this shared flow revision.", "type": "object" }, "description": { "description": "Description of the shared flow revision.", "type": "string" }, "lastModifiedAt": { "format": "int64", "type": "string", "description": "Time at which this shared flow revision was most recently modified, in milliseconds since epoch." } }, "description": "The metadata describing a shared flow revision.", "type": "object" }, "GoogleCloudApigeeV1ProfileConfig": { "type": "object", "properties": { "categories": { "items": { "$ref": "GoogleCloudApigeeV1ProfileConfigCategory" }, "description": "List of categories of profile config.", "type": "array" } }, "description": "ProfileConfig defines a set of categories and policies which will be used to compute security score.", "id": "GoogleCloudApigeeV1ProfileConfig" }, "GoogleCloudApigeeV1ListApiProxiesResponse": { "properties": { "proxies": { "items": { "$ref": "GoogleCloudApigeeV1ApiProxy" }, "type": "array" } }, "id": "GoogleCloudApigeeV1ListApiProxiesResponse", "description": "To change this message, in the same CL add a change log in go/changing-api-proto-breaks-ui", "type": "object" }, "GoogleCloudApigeeV1Reference": { "properties": { "resourceType": { "description": "The type of resource referred to by this reference. Valid values are 'KeyStore' or 'TrustStore'.", "type": "string" }, "refers": { "description": "Required. The id of the resource to which this reference refers. Must be the id of a resource that exists in the parent environment and is of the given resource_type.", "type": "string" }, "name": { "type": "string", "description": "Required. The resource id of this reference. Values must match the regular expression [\\w\\s\\-.]+." }, "description": { "type": "string", "description": "Optional. A human-readable description of this reference." } }, "type": "object", "description": "A Reference configuration. References must refer to a keystore that also exists in the parent environment.", "id": "GoogleCloudApigeeV1Reference" }, "GoogleCloudApigeeV1ActivateNatAddressRequest": { "properties": {}, "id": "GoogleCloudApigeeV1ActivateNatAddressRequest", "description": "Request for ActivateNatAddressRequest. Activate the nat address request.", "type": "object" }, "GoogleCloudApigeeV1AppGroupAppKey": { "id": "GoogleCloudApigeeV1AppGroupAppKey", "type": "object", "properties": { "expiresInSeconds": { "type": "string", "description": "Immutable. Expiration time, in seconds, for the consumer key. 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.", "format": "int64" }, "expiresAt": { "readOnly": true, "format": "int64", "description": "Output only. Time the AppGroup app expires in milliseconds since epoch.", "type": "string" }, "consumerKey": { "description": "Immutable. Consumer key.", "type": "string" }, "attributes": { "type": "array", "items": { "$ref": "GoogleCloudApigeeV1Attribute" }, "description": "List of attributes associated with the credential." }, "consumerSecret": { "description": "Secret key.", "type": "string" }, "issuedAt": { "description": "Output only. Time the AppGroup app was created in milliseconds since epoch.", "format": "int64", "type": "string", "readOnly": true }, "apiProducts": { "items": { "$ref": "GoogleCloudApigeeV1APIProductAssociation" }, "readOnly": true, "description": "Output only. List of API products and its status for which the credential can be used. **Note**: Use UpdateAppGroupAppKeyApiProductRequest API to make the association after the consumer key and secret are created.", "type": "array" }, "status": { "description": "Status of the credential. Valid values include `approved` or `revoked`.", "type": "string" }, "scopes": { "items": { "type": "string" }, "type": "array", "description": "Scopes to apply to the app. The specified scope names must already be defined for the API product that you associate with the app." } }, "description": "AppGroupAppKey contains all the information associated with the credentials." }, "GoogleCloudApigeeV1MonetizationConfig": { "id": "GoogleCloudApigeeV1MonetizationConfig", "description": "Configuration for the Monetization add-on.", "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Flag that specifies whether the Monetization add-on is enabled." } } }, "GoogleCloudApigeeV1SecurityProfileEnvironment": { "description": "Environment information of attached environments. Scoring an environment is enabled only if it is attached to a security profile.", "type": "object", "id": "GoogleCloudApigeeV1SecurityProfileEnvironment", "properties": { "attachTime": { "format": "google-datetime", "readOnly": true, "description": "Output only. Time at which environment was attached to the security profile.", "type": "string" }, "environment": { "description": "Output only. Name of the environment.", "type": "string", "readOnly": true } } }, "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequest": { "id": "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequest", "properties": { "pageSize": { "format": "int32", "type": "integer", "description": "Optional. The maximum number of results to return. The service may return fewer than this value. If unspecified, at most 50 results will be returned." }, "includeAllResources": { "$ref": "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestIncludeAll", "description": "Include all resources under the scope." }, "include": { "$ref": "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestResourceArray", "description": "Include only these resources." }, "scope": { "type": "string", "description": "Required. Scope of the resources for the computation. For Apigee, the environment is the scope of the resources." }, "profile": { "description": "Required. Name of the profile that is used for computation.", "type": "string" }, "pageToken": { "type": "string", "description": "Optional. A page token, received from a previous `BatchComputeSecurityAssessmentResults` call. Provide this to retrieve the subsequent page." } }, "description": "Request for BatchComputeSecurityAssessmentResults.", "type": "object" }, "GoogleCloudApigeeV1CustomReportMetric": { "id": "GoogleCloudApigeeV1CustomReportMetric", "properties": { "function": { "type": "string", "description": "aggregate function" }, "name": { "description": "name of the metric", "type": "string" } }, "type": "object", "description": "This encapsulates a metric property of the form sum(message_count) where name is message_count and function is sum" }, "GoogleCloudApigeeV1DebugSession": { "type": "object", "id": "GoogleCloudApigeeV1DebugSession", "properties": { "filter": { "description": "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.", "type": "string" }, "timeout": { "description": "Optional. The time in seconds after which this DebugSession should end. This value will override the value in query param, if both are provided.", "type": "string", "format": "int64" }, "count": { "description": "Optional. The number of request to be traced. Min = 1, Max = 15, Default = 10.", "type": "integer", "format": "int32" }, "name": { "description": "A unique ID for this DebugSession.", "type": "string" }, "tracesize": { "description": "Optional. The maximum number of bytes captured from the response payload. Min = 0, Max = 5120, Default = 5120.", "type": "integer", "format": "int32" }, "createTime": { "readOnly": true, "format": "google-datetime", "type": "string", "description": "Output only. The first transaction creation timestamp, recorded by UAP." }, "validity": { "format": "int32", "description": "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.", "type": "integer" } } }, "GoogleCloudApigeeV1ServiceIssuersMapping": { "properties": { "emailIds": { "items": { "type": "string" }, "description": "List of trusted issuer email ids.", "type": "array" }, "service": { "description": "String indicating the Apigee service name.", "type": "string" } }, "id": "GoogleCloudApigeeV1ServiceIssuersMapping", "type": "object" }, "GoogleCloudApigeeV1OperationMetadataProgress": { "id": "GoogleCloudApigeeV1OperationMetadataProgress", "properties": { "details": { "type": "object", "description": "The additional details of the progress.", "additionalProperties": { "description": "Properties of the object.", "type": "any" } }, "description": { "type": "string", "description": "Description of the operation's progress." }, "state": { "type": "string", "enum": [ "STATE_UNSPECIFIED", "NOT_STARTED", "IN_PROGRESS", "FINISHED" ], "description": "State of the operation.", "enumDescriptions": [ "", "", "", "" ] }, "percentDone": { "description": "The percentage of the operation progress.", "format": "int32", "type": "integer" } }, "type": "object", "description": "Information about operation progress." }, "GoogleCloudApigeeV1AccessGet": { "id": "GoogleCloudApigeeV1AccessGet", "properties": { "value": { "type": "string" }, "name": { "type": "string" } }, "description": "Get action. For example, \"Get\" : { \"name\" : \"target.name\", \"value\" : \"default\" }", "type": "object" }, "GoogleCloudApigeeV1Certificate": { "id": "GoogleCloudApigeeV1Certificate", "type": "object", "properties": { "certInfo": { "description": "Chain of certificates under this name.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1CertInfo" } } } }, "GoogleCloudApigeeV1EnvironmentGroupAttachment": { "id": "GoogleCloudApigeeV1EnvironmentGroupAttachment", "properties": { "createdAt": { "description": "Output only. The time at which the environment group attachment was created as milliseconds since epoch.", "type": "string", "readOnly": true, "format": "int64" }, "name": { "description": "ID of the environment group attachment.", "type": "string" }, "environment": { "type": "string", "description": "Required. ID of the attached environment." }, "environmentGroupId": { "readOnly": true, "type": "string", "description": "Output only. ID of the environment group." } }, "description": "EnvironmentGroupAttachment is a resource which defines an attachment of an environment to an environment group.", "type": "object" }, "GoogleCloudApigeeV1ListApiDocsResponse": { "type": "object", "properties": { "errorCode": { "description": "Unique error code for the request, if any.", "type": "string" }, "status": { "description": "Status of the operation.", "type": "string" }, "data": { "type": "array", "items": { "$ref": "GoogleCloudApigeeV1ApiDoc" }, "description": "The catalog item resources." }, "requestId": { "description": "Unique ID of the request.", "type": "string" }, "message": { "type": "string", "description": "Description of the operation." }, "nextPageToken": { "type": "string", "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages." } }, "id": "GoogleCloudApigeeV1ListApiDocsResponse" }, "GoogleCloudApigeeV1ApiProduct": { "type": "object", "properties": { "grpcOperationGroup": { "$ref": "GoogleCloudApigeeV1GrpcOperationGroup", "description": "Optional. Configuration used to group Apigee proxies with gRPC services and method names. This grouping allows us to set quota for a particular proxy with the gRPC service name and method. If a method name is not set, this implies quota and authorization are applied to all gRPC methods implemented by that proxy for that particular gRPC service." }, "name": { "type": "string", "description": "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." }, "description": { "type": "string", "description": "Description of the API product. Include key information about the API product that is not captured by other fields." }, "quotaTimeUnit": { "type": "string", "description": "Time unit defined for the `quotaInterval`. Valid values include `minute`, `hour`, `day`, or `month`." }, "displayName": { "description": "Name displayed in the UI or developer portal to developers registering for API access.", "type": "string" }, "operationGroup": { "$ref": "GoogleCloudApigeeV1OperationGroup", "description": "Configuration used 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, the API product creator is able to fine-tune and give precise control over which REST methods have access to specific resources and how many calls can be made (using the `quota` setting). **Note:** The `api_resources` setting cannot be specified for both the API product and operation group; otherwise the call will fail." }, "quota": { "description": "Number of request messages permitted per app by this API product for the specified `quotaInterval` and `quotaTimeUnit`. For example, a `quota` of 50, for a `quotaInterval` of 12 and a `quotaTimeUnit` of hours means 50 requests are allowed every 12 hours.", "type": "string" }, "lastModifiedAt": { "type": "string", "format": "int64", "description": "Response only. Modified time of this environment as milliseconds since epoch." }, "createdAt": { "type": "string", "description": "Response only. Creation time of this environment as milliseconds since epoch.", "format": "int64" }, "graphqlOperationGroup": { "$ref": "GoogleCloudApigeeV1GraphQLOperationGroup", "description": "Configuration used to group Apigee proxies or remote services with graphQL operation name, graphQL operation type and quotas. This grouping allows us to precisely set quota for a particular combination of graphQL name and operation type for a particular proxy request. If graphQL name is not set, this would imply quota will be applied on all graphQL requests matching the operation type." }, "approvalType": { "type": "string", "description": "Flag that specifies how API keys are approved to access the APIs defined by the API product. If set to `manual`, 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 to `auto`, 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." }, "proxies": { "items": { "type": "string" }, "type": "array", "description": "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. Apigee 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." }, "attributes": { "type": "array", "items": { "$ref": "GoogleCloudApigeeV1Attribute" }, "description": "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 either `public`, `private`, or `internal`. Only products marked `public` are available to developers in the Apigee developer portal. For example, you can set a product to `internal` while it is in development and then change access to `public` when it is ready to release on the portal. API products marked as `private` do not appear on the portal, but can be accessed by external developers." }, "apiResources": { "description": "Comma-separated list of API resources to be bundled in the API product. By default, the resource paths are mapped from the `proxy.pathsuffix` variable. The proxy path suffix is defined as the URI fragment following the ProxyEndpoint base path. For example, if the `apiResources` 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 Managing API products.", "type": "array", "items": { "type": "string" } }, "quotaCounterScope": { "type": "string", "enum": [ "QUOTA_COUNTER_SCOPE_UNSPECIFIED", "PROXY", "OPERATION" ], "enumDescriptions": [ "When quota is not explicitly defined for each operation(REST/GraphQL), the limits set at product level will be used as a local counter for quota evaluation by all the operations, independent of proxy association.", "When quota is not explicitly defined for each operation(REST/GraphQL), set at product level will be used as a global counter for quota evaluation by all the operations associated with a particular proxy.", "When quota is not explicitly defined for each operation(REST/GraphQL), the limits set at product level will be used as a local counter for quota evaluation by all the operations, independent of proxy association. This behavior mimics the same as QUOTA_COUNTER_SCOPE_UNSPECIFIED." ], "description": "Scope of the quota decides how the quota counter gets applied and evaluate for quota violation. If the Scope is set as PROXY, then all the operations defined for the APIproduct that are associated with the same proxy will share the same quota counter set at the APIproduct level, making it a global counter at a proxy level. If the Scope is set as OPERATION, then each operations get the counter set at the API product dedicated, making it a local counter. Note that, the QuotaCounterScope applies only when an operation does not have dedicated quota set for itself." }, "environments": { "description": "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`.", "type": "array", "items": { "type": "string" } }, "scopes": { "items": { "type": "string" }, "type": "array", "description": "Comma-separated list of OAuth scopes that are validated at runtime. Apigee validates that the scopes in any access token presented match the scopes defined in the OAuth policy associated with the API product." }, "quotaInterval": { "description": "Time interval over which the number of request messages is calculated.", "type": "string" } }, "id": "GoogleCloudApigeeV1ApiProduct" }, "GoogleCloudApigeeV1RuntimeTraceSamplingConfig": { "id": "GoogleCloudApigeeV1RuntimeTraceSamplingConfig", "properties": { "sampler": { "type": "string", "enum": [ "SAMPLER_UNSPECIFIED", "OFF", "PROBABILITY" ], "description": "Sampler of distributed tracing. OFF is the default value.", "enumDescriptions": [ "Sampler unspecified.", "OFF means distributed trace is disabled, or the sampling probability is 0.", "PROBABILITY means traces are captured on a probability that defined by sampling_rate. The sampling rate is limited to 0 to 0.5 when this is set." ] }, "samplingRate": { "type": "number", "format": "float", "description": "Field sampling rate. This value is only applicable when using the PROBABILITY sampler. The supported values are \u003e 0 and \u003c= 0.5." } }, "description": "NEXT ID: 3 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.", "type": "object" }, "GoogleCloudApigeeV1AccessRemove": { "type": "object", "description": "Remove action. For example, \"Remove\" : { \"name\" : \"target.name\", \"success\" : true }", "properties": { "name": { "type": "string" }, "success": { "type": "boolean" } }, "id": "GoogleCloudApigeeV1AccessRemove" }, "GoogleCloudApigeeV1ListSecurityActionsResponse": { "properties": { "nextPageToken": { "type": "string", "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages." }, "securityActions": { "type": "array", "items": { "$ref": "GoogleCloudApigeeV1SecurityAction" }, "description": "The SecurityActions for the specified environment." } }, "type": "object", "description": "Contains a list of SecurityActions in response to a ListSecurityActionRequest.", "id": "GoogleCloudApigeeV1ListSecurityActionsResponse" }, "GoogleTypeExpr": { "type": "object", "properties": { "location": { "type": "string", "description": "Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file." }, "title": { "type": "string", "description": "Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression." }, "description": { "description": "Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.", "type": "string" }, "expression": { "type": "string", "description": "Textual representation of an expression in Common Expression Language syntax." } }, "description": "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() \u003c 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.", "id": "GoogleTypeExpr" }, "GoogleCloudApigeeV1Instance": { "type": "object", "id": "GoogleCloudApigeeV1Instance", "description": "Apigee runtime instance.", "properties": { "description": { "type": "string", "description": "Optional. Description of the instance." }, "location": { "description": "Required. Compute Engine location where the instance resides.", "type": "string" }, "port": { "readOnly": true, "description": "Output only. Port number of the exposed Apigee endpoint.", "type": "string" }, "host": { "description": "Output only. Internal hostname or IP address of the Apigee endpoint used by clients to connect to the service.", "type": "string", "readOnly": true }, "name": { "description": "Required. Resource ID of the instance. Values must match the regular expression `^a-z{0,30}[a-z\\d]$`.", "type": "string" }, "createdAt": { "type": "string", "readOnly": true, "description": "Output only. Time the instance was created in milliseconds since epoch.", "format": "int64" }, "consumerAcceptList": { "items": { "type": "string" }, "description": "Optional. Customer accept list represents the list of projects (id/number) on customer side that can privately connect to the service attachment. It is an optional field which the customers can provide during the instance creation. By default, the customer project associated with the Apigee organization will be included to the list.", "type": "array" }, "peeringCidrRange": { "deprecated": true, "description": "Optional. Size of the CIDR block range that will be reserved by the instance. PAID organizations support `SLASH_16` to `SLASH_20` and defaults to `SLASH_16`. Evaluation organizations support only `SLASH_23`.", "type": "string", "enumDescriptions": [ "Range not specified.", "`/16` CIDR range.", "`/17` CIDR range.", "`/18` CIDR range.", "`/19` CIDR range.", "`/20` CIDR range.", "`/22` CIDR range. Supported for evaluation only.", "`/23` CIDR range. Supported for evaluation only." ], "enum": [ "CIDR_RANGE_UNSPECIFIED", "SLASH_16", "SLASH_17", "SLASH_18", "SLASH_19", "SLASH_20", "SLASH_22", "SLASH_23" ] }, "accessLoggingConfig": { "description": "Optional. Access logging configuration enables the access logging feature at the instance. Apigee customers can enable access logging to ship the access logs to their own project's cloud logging.", "$ref": "GoogleCloudApigeeV1AccessLoggingConfig" }, "displayName": { "type": "string", "description": "Optional. Display name for the instance." }, "runtimeVersion": { "type": "string", "description": "Output only. Version of the runtime system running in the instance. The runtime system is the set of components that serve the API Proxy traffic in your Environments.", "readOnly": true }, "diskEncryptionKeyName": { "type": "string", "description": "Customer Managed Encryption Key (CMEK) used for disk and volume encryption. If not specified, a Google-Managed encryption key will be used. Use the following format: `projects/([^/]+)/locations/([^/]+)/keyRings/([^/]+)/cryptoKeys/([^/]+)`" }, "lastModifiedAt": { "format": "int64", "readOnly": true, "description": "Output only. Time the instance was last modified in milliseconds since epoch.", "type": "string" }, "ipRange": { "description": "Optional. Comma-separated list of CIDR blocks of length 22 and/or 28 used to create the Apigee instance. Providing CIDR ranges is optional. You can provide just /22 or /28 or both (or neither). Ranges you provide should be freely available as part of a larger named range you have allocated to the Service Networking peering. If this parameter is not provided, Apigee automatically requests an available /22 and /28 CIDR block from Service Networking. Use the /22 CIDR block for configuring your firewall needs to allow traffic from Apigee. Input formats: `a.b.c.d/22` or `e.f.g.h/28` or `a.b.c.d/22,e.f.g.h/28`", "type": "string" }, "serviceAttachment": { "readOnly": true, "description": "Output only. Resource name of the service attachment created for the instance in the format: `projects/*/regions/*/serviceAttachments/*` Apigee customers can privately forward traffic to this service attachment using the PSC endpoints.", "type": "string" }, "state": { "enumDescriptions": [ "Resource is in an unspecified state.", "Resource is being created.", "Resource is provisioned and ready to use.", "The resource is being deleted.", "The resource is being updated." ], "enum": [ "STATE_UNSPECIFIED", "CREATING", "ACTIVE", "DELETING", "UPDATING" ], "readOnly": true, "description": "Output only. State of the instance. Values other than `ACTIVE` means the resource is not ready to use.", "type": "string" } } }, "GoogleCloudApigeeV1QueryTabularStatsResponse": { "properties": { "columns": { "items": { "type": "string" }, "type": "array", "description": "Column names corresponding to the same order as the inner values in the stats field." }, "values": { "type": "array", "items": { "items": { "type": "any" }, "type": "array" }, "description": "Resultant rows from the executed query." }, "nextPageToken": { "description": "Next page token.", "type": "string" } }, "id": "GoogleCloudApigeeV1QueryTabularStatsResponse", "description": "Encapsulates two kinds of stats that are results of the dimensions and aggregations requested. - Tabular rows. - Time series data. Example of tabular rows, Represents security stats results as a row of flat values.", "type": "object" }, "GoogleCloudApigeeV1ProfileConfigCORS": { "id": "GoogleCloudApigeeV1ProfileConfigCORS", "description": "Checks to see if you have CORS policy in place.", "type": "object", "properties": {} }, "GoogleCloudApigeeV1GrpcOperationConfig": { "properties": { "quota": { "description": "Quota parameters to be enforced for the methods and API source combination. If none are specified, quota enforcement will not be done.", "$ref": "GoogleCloudApigeeV1Quota" }, "methods": { "items": { "type": "string" }, "description": "List of unqualified gRPC method names for the proxy to which quota will be applied. If this field is empty, the Quota will apply to all operations on the gRPC service defined on the proxy. Example: Given a proxy that is configured to serve com.petstore.PetService, the methods com.petstore.PetService.ListPets and com.petstore.PetService.GetPet would be specified here as simply [\"ListPets\", \"GetPet\"].", "type": "array" }, "service": { "description": "Required. gRPC Service name associated to be associated with the API proxy, on which quota rules can be applied upon.", "type": "string" }, "apiSource": { "description": "Required. Name of the API proxy with which the gRPC operation and quota are associated.", "type": "string" }, "attributes": { "type": "array", "items": { "$ref": "GoogleCloudApigeeV1Attribute" }, "description": "Custom attributes associated with the operation." } }, "description": "Binds the resources in a proxy or remote service with the gRPC operation and its associated quota enforcement.", "type": "object", "id": "GoogleCloudApigeeV1GrpcOperationConfig" }, "GoogleCloudApigeeV1Quota": { "id": "GoogleCloudApigeeV1Quota", "type": "object", "description": "Quota contains the essential parameters needed that can be applied on the resources, methods, API source combination associated with this API product. While Quota is optional, setting it prevents requests from exceeding the provisioned parameters.", "properties": { "timeUnit": { "type": "string", "description": "Time unit defined for the `interval`. Valid values include `minute`, `hour`, `day`, or `month`. If `limit` and `interval` are valid, the default value is `hour`; otherwise, the default is null." }, "interval": { "description": "Required. Time interval over which the number of request messages is calculated.", "type": "string" }, "limit": { "description": "Required. Upper limit allowed for the time interval and time unit specified. Requests exceeding this limit will be rejected.", "type": "string" } } }, "GoogleCloudApigeeV1Metric": { "id": "GoogleCloudApigeeV1Metric", "properties": { "values": { "type": "array", "items": { "type": "any" }, "description": "List of metric values. Possible value formats include: `\"values\":[\"39.0\"]` or `\"values\":[ { \"value\": \"39.0\", \"timestamp\": 1232434354} ]`" }, "name": { "description": "Metric name.", "type": "string" } }, "type": "object", "description": "Encapsulates the metric data point. For example: ```{ \"name\": \"sum(message_count)\", \"values\" : [ { \"timestamp\": 1549004400000, \"value\": \"39.0\" }, { \"timestamp\" : 1548997200000, \"value\" : \"0.0\" } ] }``` or ```{ \"name\": \"sum(message_count)\", \"values\" : [\"39.0\"] }```" }, "GoogleCloudApigeeV1EnvironmentGroupConfig": { "type": "object", "properties": { "hostnames": { "description": "Host names for the environment group.", "type": "array", "items": { "type": "string" } }, "endpointChainingRules": { "items": { "$ref": "GoogleCloudApigeeV1EndpointChainingRule" }, "type": "array", "description": "A list of proxies in each deployment group for proxy chaining calls." }, "routingRules": { "description": "Ordered list of routing rules defining how traffic to this environment group's hostnames should be routed to different environments.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1RoutingRule" } }, "name": { "type": "string", "description": "Name of the environment group in the following format: `organizations/{org}/envgroups/{envgroup}`." }, "uid": { "description": "A unique id for the environment group config that will only change if the environment group is deleted and recreated.", "type": "string" }, "revisionId": { "type": "string", "description": "Revision id that defines the ordering of the EnvironmentGroupConfig resource. The higher the revision, the more recently the configuration was deployed.", "format": "int64" }, "location": { "description": "When this message appears in the top-level IngressConfig, this field will be populated in lieu of the inlined routing_rules and hostnames fields. Some URL for downloading the full EnvironmentGroupConfig for this group.", "type": "string" } }, "description": "EnvironmentGroupConfig is a revisioned snapshot of an EnvironmentGroup and its associated routing rules.", "id": "GoogleCloudApigeeV1EnvironmentGroupConfig" }, "GoogleCloudApigeeV1ListDeploymentsResponse": { "id": "GoogleCloudApigeeV1ListDeploymentsResponse", "properties": { "deployments": { "type": "array", "description": "List of deployments.", "items": { "$ref": "GoogleCloudApigeeV1Deployment" } } }, "type": "object" }, "GoogleCloudApigeeV1DimensionMetric": { "id": "GoogleCloudApigeeV1DimensionMetric", "description": "Encapsulates a metric grouped by dimension.", "type": "object", "properties": { "name": { "description": "Comma joined dimension names. E.g. \"dim1_name,dim2_name\". Deprecated. If name already has comma before join, we may get wrong splits. Please use individual_names.", "deprecated": true, "type": "string" }, "metrics": { "items": { "$ref": "GoogleCloudApigeeV1Metric" }, "type": "array", "description": "List of metrics." }, "individualNames": { "items": { "type": "string" }, "type": "array", "description": "Individual dimension names. E.g. [\"dim1_name\", \"dim2_name\"]." } } }, "GoogleCloudApigeeV1SecurityAssessmentResultScoringResultAssessmentRecommendationRecommendationLink": { "type": "object", "id": "GoogleCloudApigeeV1SecurityAssessmentResultScoringResultAssessmentRecommendationRecommendationLink", "properties": { "text": { "description": "The text of the url. (ie: \"Learn more\")", "type": "string" }, "uri": { "description": "The link itself.", "type": "string" } }, "description": "The format for a link in the recommendation." }, "GoogleCloudApigeeV1Metadata": { "description": "Encapsulates additional information about query execution.", "type": "object", "properties": { "notices": { "description": "List of additional information such as data source, if result was truncated. For example: ``` \"notices\": [ \"Source:Postgres\", \"PG Host:uappg0rw.e2e.apigeeks.net\", \"query served by:4b64601e-40de-4eb1-bfb9-eeee7ac929ed\", \"Table used: edge.api.uapgroup2.agg_api\" ]```", "type": "array", "items": { "type": "string" } }, "errors": { "description": "List of error messages as strings.", "type": "array", "items": { "type": "string" } } }, "id": "GoogleCloudApigeeV1Metadata" }, "GoogleCloudApigeeV1ProfileConfigAbuse": { "id": "GoogleCloudApigeeV1ProfileConfigAbuse", "description": "Checks for abuse, which includes any requests sent to the API for purposes other than what it is intended for, such as high volumes of requests, data scraping, and abuse related to authorization.", "properties": {}, "type": "object" }, "GoogleCloudApigeeV1ComputeEnvironmentScoresResponse": { "properties": { "nextPageToken": { "type": "string", "description": "A page token, received from a previous `ComputeScore` call. Provide this to retrieve the subsequent page." }, "scores": { "description": "List of scores. One score per day.", "items": { "$ref": "GoogleCloudApigeeV1Score" }, "type": "array" } }, "type": "object", "id": "GoogleCloudApigeeV1ComputeEnvironmentScoresResponse", "description": "Response for ComputeEnvironmentScores." }, "GoogleCloudApigeeV1SyncAuthorization": { "type": "object", "id": "GoogleCloudApigeeV1SyncAuthorization", "properties": { "identities": { "items": { "type": "string" }, "description": "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).", "type": "array" }, "etag": { "type": "string", "description": "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.", "format": "byte" } } }, "GoogleCloudApigeeV1SecurityAssessmentResult": { "properties": { "scoringResult": { "description": "The result of the assessment.", "$ref": "GoogleCloudApigeeV1SecurityAssessmentResultScoringResult" }, "error": { "$ref": "GoogleRpcStatus", "description": "The error status if scoring fails." }, "createTime": { "description": "The time of the assessment of this resource. This could lag behind `assessment_time` due to caching within the backend.", "type": "string", "format": "google-datetime" }, "resource": { "description": "The assessed resource.", "$ref": "GoogleCloudApigeeV1SecurityAssessmentResultResource" } }, "description": "The security assessment result for one resource.", "id": "GoogleCloudApigeeV1SecurityAssessmentResult", "type": "object" }, "GoogleCloudApigeeV1ProfileConfigMTLS": { "type": "object", "properties": {}, "id": "GoogleCloudApigeeV1ProfileConfigMTLS", "description": "Checks to see if you have configured mTLS for the target server." }, "GoogleCloudApigeeV1ListInstancesResponse": { "type": "object", "id": "GoogleCloudApigeeV1ListInstancesResponse", "properties": { "nextPageToken": { "type": "string", "description": "Page token that you can include in a ListInstance request to retrieve the next page of content. If omitted, no subsequent pages exist." }, "instances": { "description": "Instances in the specified organization.", "items": { "$ref": "GoogleCloudApigeeV1Instance" }, "type": "array" } }, "description": "Response for ListInstances." }, "GoogleCloudApigeeV1RuntimeTraceConfigOverride": { "id": "GoogleCloudApigeeV1RuntimeTraceConfigOverride", "description": "NEXT ID: 7 Trace configuration override for a specific API proxy in an environment.", "type": "object", "properties": { "uid": { "type": "string", "description": "Unique ID for the configuration override. The ID will only change if the override is deleted and recreated. Corresponds to name's \"override\" field." }, "apiProxy": { "description": "Name of the API proxy that will have its trace configuration overridden following format: `organizations/{org}/apis/{api}`", "type": "string" }, "revisionCreateTime": { "format": "google-datetime", "description": "The timestamp that the revision was created or updated.", "type": "string" }, "revisionId": { "type": "string", "description": "Revision number which can be used by the runtime to detect if the trace config override has changed between two versions." }, "name": { "type": "string", "description": "Name of the trace config override in the following format: `organizations/{org}/environment/{env}/traceConfig/overrides/{override}`" }, "samplingConfig": { "$ref": "GoogleCloudApigeeV1RuntimeTraceSamplingConfig", "description": "Trace configuration override for a specific API proxy in an environment." } } }, "GoogleCloudApigeeV1RuntimeAnalyticsConfig": { "id": "GoogleCloudApigeeV1RuntimeAnalyticsConfig", "type": "object", "description": "Runtime configuration for the Analytics add-on.", "properties": { "billingPipelineEnabled": { "description": "If Runtime should send billing data to AX or not.", "type": "boolean" }, "enabled": { "type": "boolean", "description": "If the Analytics is enabled or not." } } }, "GoogleCloudApigeeV1ComputeEnvironmentScoresRequest": { "id": "GoogleCloudApigeeV1ComputeEnvironmentScoresRequest", "type": "object", "properties": { "timeRange": { "$ref": "GoogleTypeInterval", "description": "Required. Time range for score calculation. At most 14 days of scores will be returned, and both the start and end dates must be within the last 90 days." }, "pageSize": { "format": "int32", "description": "Optional. The maximum number of subcomponents to be returned in a single page. The service may return fewer than this value. If unspecified, at most 100 subcomponents will be returned in a single page.", "type": "integer" }, "filters": { "type": "array", "description": "Optional. Filters are used to filter scored components. Return all the components if no filter is mentioned. Example: [{ \"scorePath\": \"/org@myorg/envgroup@myenvgroup/env@myenv/proxies/proxy@myproxy/source\" }, { \"scorePath\": \"/org@myorg/envgroup@myenvgroup/env@myenv/proxies/proxy@myproxy/target\", }] This will return components with path: \"/org@myorg/envgroup@myenvgroup/env@myenv/proxies/proxy@myproxy/source\" OR \"/org@myorg/envgroup@myenvgroup/env@myenv/proxies/proxy@myproxy/target\"", "items": { "$ref": "GoogleCloudApigeeV1ComputeEnvironmentScoresRequestFilter" } }, "pageToken": { "description": "Optional. A token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } }, "description": "Request for ComputeEnvironmentScores." }, "GoogleCloudApigeeV1ApiDoc": { "id": "GoogleCloudApigeeV1ApiDoc", "properties": { "apiProductName": { "type": "string", "description": "Required. Immutable. The `name` field of the associated [API product](/apigee/docs/reference/apis/apigee/rest/v1/organizations.apiproducts). A portal may have only one catalog item associated with a given API product." }, "anonAllowed": { "description": "Optional. Boolean flag that manages user access to the catalog item. When true, the catalog item has public visibility and can be viewed anonymously; otherwise, only registered users may view it. Note: when the parent portal is enrolled in the [audience management feature](https://cloud.google.com/apigee/docs/api-platform/publish/portal/portal-audience#enrolling_in_the_beta_release_of_the_audience_management_feature), and this flag is set to false, visibility is set to an indeterminate state and must be explicitly specified in the management UI (see [Manage the visibility of an API in your portal](https://cloud.google.com/apigee/docs/api-platform/publish/portal/publish-apis#visibility)). Additionally, when enrolled in the audience management feature, updates to this flag will be ignored as visibility permissions must be updated in the management UI.", "type": "boolean" }, "requireCallbackUrl": { "description": "Optional. Whether a callback URL is required when this catalog item's API product is enabled in a developer app. When true, a portal user will be required to input a URL when managing the app (this is typically used for the app's OAuth flow).", "type": "boolean" }, "graphqlEndpointUrl": { "deprecated": true, "type": "string", "description": "Optional. DEPRECATED: manage documentation through the `getDocumentation` and `updateDocumentation` methods" }, "published": { "type": "boolean", "description": "Optional. Denotes whether the catalog item is published to the portal or is in a draft state. When the parent portal is enrolled in the [audience management feature](https://cloud.google.com/apigee/docs/api-platform/publish/portal/portal-audience#enrolling_in_the_beta_release_of_the_audience_management_feature), the visibility can be set to public on creation by setting the anonAllowed flag to true or further managed in the management UI (see [Manage the visibility of an API in your portal](https://cloud.google.com/apigee/docs/api-platform/publish/portal/publish-apis#visibility)) before it can be visible to any users. If not enrolled in the audience management feature, the visibility is managed by the `anonAllowed` flag." }, "specId": { "type": "string", "description": "Optional. DEPRECATED: DO NOT USE", "deprecated": true }, "edgeAPIProductName": { "description": "Optional. Immutable. DEPRECATED: use the `apiProductName` field instead", "type": "string" }, "id": { "type": "string", "readOnly": true, "description": "Output only. The ID of the catalog item.", "format": "int64" }, "modified": { "type": "string", "format": "int64", "readOnly": true, "description": "Output only. Time the catalog item was last modified in milliseconds since epoch." }, "graphqlSchemaDisplayName": { "deprecated": true, "type": "string", "description": "Optional. DEPRECATED: manage documentation through the `getDocumentation` and `updateDocumentation` methods" }, "description": { "type": "string", "description": "Optional. Description of the catalog item. Max length is 10,000 characters." }, "visibility": { "type": "boolean", "description": "Optional. DEPRECATED: use the `published` field instead" }, "siteId": { "description": "Output only. The ID of the parent portal.", "readOnly": true, "type": "string" }, "imageUrl": { "type": "string", "description": "Optional. Location of the image used for the catalog item in the catalog. This can be either an image with an external URL or a file path for [image files stored in the portal](/apigee/docs/api-platform/publish/portal/portal-files\"), for example, `/files/book-tree.jpg`. When specifying the URL of an external image, the image won't be uploaded to your assets; additionally, loading the image in the integrated portal will be subject to its availability, which may be blocked or restricted by [content security policies](/apigee/docs/api-platform/publish/portal/csp). Max length of file path is 2,083 characters." }, "categoryIds": { "items": { "type": "string" }, "description": "Optional. The IDs of the API categories to which this catalog item belongs.", "type": "array" }, "graphqlSchema": { "type": "string", "deprecated": true, "description": "Optional. DEPRECATED: manage documentation through the `getDocumentation` and `updateDocumentation` methods" }, "title": { "type": "string", "description": "Required. The user-facing name of the catalog item. `title` must be a non-empty string with a max length of 255 characters." } }, "type": "object", "description": "`ApiDoc` represents an API catalog item. Catalog items are used in two ways in a portal: - Users can browse and interact with a visual representation of the API documentation - The `api_product_name` field provides a link to a backing [API product] (/apigee/docs/reference/apis/apigee/rest/v1/organizations.apiproducts). Through this link, portal users can create and manage developer apps linked to one or more API products." }, "GoogleCloudApigeeV1UpdateSecurityIncidentRequest": { "description": "Request for UpdateSecurityIncident.", "type": "object", "properties": { "updateMask": { "format": "google-fieldmask", "description": "Required. The list of fields to update. Allowed fields are: LINT.IfChange(allowed_update_fields_comment) - observability LINT.ThenChange()", "type": "string" }, "securityIncident": { "description": "Required. The security incident to update. Must contain all existing populated fields of the current incident.", "$ref": "GoogleCloudApigeeV1SecurityIncident" } }, "id": "GoogleCloudApigeeV1UpdateSecurityIncidentRequest" }, "GoogleCloudApigeeV1DebugSessionTransaction": { "properties": { "completed": { "type": "boolean", "description": "Flag indicating whether a transaction is completed or not" }, "point": { "description": "List of debug data collected by runtime plane at various defined points in the flow.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1Point" } } }, "type": "object", "id": "GoogleCloudApigeeV1DebugSessionTransaction", "description": "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." }, "GoogleApiHttpBody": { "type": "object", "id": "GoogleApiHttpBody", "properties": { "contentType": { "description": "The HTTP Content-Type header value specifying the content type of the body.", "type": "string" }, "extensions": { "type": "array", "description": "Application specific response metadata. Must be set in the first response for streaming APIs.", "items": { "type": "object", "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", "type": "any" } } }, "data": { "type": "string", "format": "byte", "description": "The HTTP request/response body as raw binary." } }, "description": "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." }, "GoogleCloudApigeeV1RevisionStatus": { "id": "GoogleCloudApigeeV1RevisionStatus", "properties": { "replicas": { "description": "The number of replicas that have successfully loaded this revision.", "format": "int32", "type": "integer" }, "revisionId": { "type": "string", "description": "The revision of the resource." }, "jsonSpec": { "type": "string", "description": "The json content of the resource revision. Large specs should be sent individually via the spec field to avoid hitting request size limits." }, "errors": { "description": "Errors reported when attempting to load this revision.", "items": { "$ref": "GoogleCloudApigeeV1UpdateError" }, "type": "array" } }, "description": "The status of a specific resource revision.", "type": "object" }, "GoogleCloudApigeeV1RevenueShareRange": { "description": "API call volume range and the percentage of revenue to share with the developer when the total number of API calls is within the range.", "properties": { "end": { "description": "Ending value of the range. Set to 0 or `null` for the last range of values.", "type": "string", "format": "int64" }, "sharePercentage": { "format": "double", "type": "number", "description": "Percentage of the revenue to be shared with the developer. For example, to share 21 percent of the total revenue with the developer, set this value to 21. Specify a decimal number with a maximum of two digits following the decimal point." }, "start": { "type": "string", "description": "Starting value of the range. Set to 0 or `null` for the initial range of values.", "format": "int64" } }, "id": "GoogleCloudApigeeV1RevenueShareRange", "type": "object" }, "GoogleCloudApigeeV1ProvisionOrganizationRequest": { "properties": { "runtimeLocation": { "type": "string", "description": "Cloud Platform location for the runtime instance. Defaults to zone `us-west1-a`. If a region is provided, `EVAL` organizations will use the region for automatically selecting a zone for the runtime instance." }, "analyticsRegion": { "description": "Primary Cloud Platform region for analytics data storage. For valid values, see [Create an organization](https://cloud.google.com/apigee/docs/hybrid/latest/precog-provision). Defaults to `us-west1`.", "type": "string" }, "authorizedNetwork": { "type": "string", "description": "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). 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`" }, "disableVpcPeering": { "type": "boolean", "description": "Optional. Flag that specifies whether the VPC Peering through Private Google Access should be disabled between the consumer network and Apigee. 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." } }, "description": "Request for ProvisionOrganization.", "type": "object", "id": "GoogleCloudApigeeV1ProvisionOrganizationRequest" }, "GoogleCloudApigeeV1Environment": { "type": "object", "properties": { "hasAttachedFlowHooks": { "type": "boolean" }, "nodeConfig": { "description": "Optional. NodeConfig of the environment.", "$ref": "GoogleCloudApigeeV1NodeConfig" }, "createdAt": { "format": "int64", "description": "Output only. Creation time of this environment as milliseconds since epoch.", "type": "string", "readOnly": true }, "properties": { "$ref": "GoogleCloudApigeeV1Properties", "description": "Optional. Key-value pairs that may be used for customizing the environment." }, "description": { "description": "Optional. Description of the environment.", "type": "string" }, "deploymentType": { "type": "string", "enum": [ "DEPLOYMENT_TYPE_UNSPECIFIED", "PROXY", "ARCHIVE" ], "enumDescriptions": [ "Deployment type not specified.", "Proxy deployment enables you to develop and deploy API proxies using Apigee on Google Cloud. This cannot currently be combined with the CONFIGURABLE API proxy type.", "Archive deployment enables you to develop API proxies locally then deploy an archive of your API proxy configuration to an environment in Apigee on Google Cloud. You will be prevented from performing a [subset of actions](/apigee/docs/api-platform/local-development/overview#prevented-actions) within the environment." ], "description": "Optional. Deployment type supported by the environment. The deployment type can be set when creating the environment and cannot be changed. When you enable archive deployment, you will be **prevented from performing** a [subset of actions](/apigee/docs/api-platform/local-development/overview#prevented-actions) within the environment, including: * Managing the deployment of API proxy or shared flow revisions * Creating, updating, or deleting resource files * Creating, updating, or deleting target servers" }, "type": { "description": "Optional. EnvironmentType selected for the environment.", "enumDescriptions": [ "Environment type not specified.", "This is the default type. Base environment has limited capacity and capabilities and are usually used when you are getting started with Apigee or while experimenting. Refer to Apigee's public documentation for more details.", "Intermediate environment supports API management features and higher capacity than Base environment. Refer to Apigee's public documentation for more details.", "Comprehensive environment supports advanced capabilites and even higher capacity than Intermediate environment. Refer to Apigee's public documentation for more details." ], "type": "string", "enum": [ "ENVIRONMENT_TYPE_UNSPECIFIED", "BASE", "INTERMEDIATE", "COMPREHENSIVE" ] }, "state": { "enumDescriptions": [ "Resource is in an unspecified state.", "Resource is being created.", "Resource is provisioned and ready to use.", "The resource is being deleted.", "The resource is being updated." ], "enum": [ "STATE_UNSPECIFIED", "CREATING", "ACTIVE", "DELETING", "UPDATING" ], "readOnly": true, "description": "Output only. State of the environment. Values other than ACTIVE means the resource is not ready to use.", "type": "string" }, "lastModifiedAt": { "type": "string", "format": "int64", "readOnly": true, "description": "Output only. Last modification time of this environment as milliseconds since epoch." }, "name": { "type": "string", "description": "Required. Name of the environment. Values must match the regular expression `^[.\\\\p{Alnum}-_]{1,255}$`" }, "apiProxyType": { "enum": [ "API_PROXY_TYPE_UNSPECIFIED", "PROGRAMMABLE", "CONFIGURABLE" ], "enumDescriptions": [ "API proxy type not specified.", "Programmable API Proxies enable you to develop APIs with highly flexible behavior using bundled policy configuration and one or more programming languages to describe complex sequential and/or conditional flows of logic.", "Configurable API Proxies enable you to develop efficient APIs using simple configuration while complex execution control flow logic is handled by Apigee. This type only works with the ARCHIVE deployment type and cannot be combined with the PROXY deployment type." ], "description": "Optional. API Proxy type supported by the environment. The type can be set when creating the Environment and cannot be changed.", "type": "string" }, "displayName": { "description": "Optional. Display name for this environment.", "type": "string" }, "forwardProxyUri": { "type": "string", "description": "Optional. URI of the forward proxy to be applied to the runtime instances in this environment. Must be in the format of {scheme}://{hostname}:{port}. Note that the scheme must be one of \"http\" or \"https\", and the port must be supplied. To remove a forward proxy setting, update the field to an empty value. Note: At this time, PUT operations to add forwardProxyUri to an existing environment fail if the environment has nodeConfig set up. To successfully add the forwardProxyUri setting in this case, include the NodeConfig details with the request." } }, "id": "GoogleCloudApigeeV1Environment" }, "GoogleCloudApigeeV1ListDeveloperAppsResponse": { "id": "GoogleCloudApigeeV1ListDeveloperAppsResponse", "properties": { "app": { "type": "array", "description": "List of developer apps and their credentials.", "items": { "$ref": "GoogleCloudApigeeV1DeveloperApp" } } }, "type": "object" }, "GoogleCloudApigeeV1InstanceDeploymentStatusDeployedRevision": { "description": "Revisions deployed in the MPs.", "id": "GoogleCloudApigeeV1InstanceDeploymentStatusDeployedRevision", "type": "object", "properties": { "revision": { "description": "API proxy revision reported as deployed.", "type": "string" }, "percentage": { "format": "int32", "description": "Percentage of MP replicas reporting this revision.", "type": "integer" } } }, "GoogleCloudApigeeV1ListApiCategoriesResponse": { "id": "GoogleCloudApigeeV1ListApiCategoriesResponse", "description": "The response for `ListApiCategoriesRequest`. Next ID: 6", "type": "object", "properties": { "status": { "type": "string", "description": "Status of the operation." }, "errorCode": { "type": "string", "description": "Unique error code for the request, if any." }, "data": { "items": { "$ref": "GoogleCloudApigeeV1ApiCategory" }, "description": "The API category resources.", "type": "array" }, "message": { "description": "Description of the operation.", "type": "string" }, "requestId": { "description": "Unique ID of the request.", "type": "string" } } }, "GoogleCloudApigeeV1TlsInfo": { "properties": { "keyStore": { "description": "Required if `client_auth_enabled` is true. The resource ID of the keystore.", "type": "string" }, "ignoreValidationErrors": { "type": "boolean", "description": "If true, Edge ignores TLS certificate errors. Valid when configuring TLS for target servers and target endpoints, and when configuring virtual hosts that use 2-way TLS. When used with a target endpoint/target server, if the backend system uses SNI and returns a cert with a subject Distinguished Name (DN) that does not match the hostname, there is no way to ignore the error and the connection fails." }, "commonName": { "description": "The TLS Common Name of the certificate.", "$ref": "GoogleCloudApigeeV1TlsInfoCommonName" }, "enabled": { "type": "boolean", "description": "Required. Enables TLS. If false, neither one-way nor two-way TLS will be enabled." }, "ciphers": { "description": "The SSL/TLS cipher suites to be used. For programmable proxies, it must be one of the cipher suite names listed in: http://docs.oracle.com/javase/8/docs/technotes/guides/security/StandardNames.html#ciphersuites. For configurable proxies, it must follow the configuration specified in: https://commondatastorage.googleapis.com/chromium-boringssl-docs/ssl.h.html#Cipher-suite-configuration. This setting has no effect for configurable proxies when negotiating TLS 1.3.", "type": "array", "items": { "type": "string" } }, "trustStore": { "type": "string", "description": "The resource ID of the truststore." }, "enforce": { "description": "TLS is strictly enforced.", "type": "boolean" }, "clientAuthEnabled": { "type": "boolean", "description": "Optional. Enables two-way TLS." }, "keyAlias": { "type": "string", "description": "Required if `client_auth_enabled` is true. The resource ID for the alias containing the private key and cert." }, "protocols": { "items": { "type": "string" }, "type": "array", "description": "The TLS versioins to be used." } }, "type": "object", "description": "TLS configuration information for virtual hosts and TargetServers.", "id": "GoogleCloudApigeeV1TlsInfo" } }, "auth": { "oauth2": { "scopes": { "https://www.googleapis.com/auth/cloud-platform": { "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." } } } }, "icons": { "x32": "http://www.google.com/images/icons/product/search-32.gif", "x16": "http://www.google.com/images/icons/product/search-16.gif" }, "fullyEncodeReservedExpansion": true }