{ "parameters": { "uploadType": { "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", "location": "query", "type": "string" }, "alt": { "description": "Data format for response.", "default": "json", "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ], "enum": [ "json", "media", "proto" ], "location": "query", "type": "string" }, "access_token": { "type": "string", "description": "OAuth access token.", "location": "query" }, "oauth_token": { "type": "string", "description": "OAuth 2.0 token for the current user.", "location": "query" }, "upload_protocol": { "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", "location": "query", "type": "string" }, "fields": { "type": "string", "description": "Selector specifying which fields to include in a partial response.", "location": "query" }, "quotaUser": { "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.", "location": "query", "type": "string" }, "callback": { "description": "JSONP", "location": "query", "type": "string" }, "prettyPrint": { "description": "Returns response with indentations and line breaks.", "default": "true", "location": "query", "type": "boolean" }, "$.xgafv": { "description": "V1 error format.", "enumDescriptions": [ "v1 error format", "v2 error format" ], "type": "string", "enum": [ "1", "2" ], "location": "query" }, "key": { "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.", "location": "query", "type": "string" } }, "icons": { "x32": "http://www.google.com/images/icons/product/search-32.gif", "x16": "http://www.google.com/images/icons/product/search-16.gif" }, "revision": "20260409", "canonicalName": "Apigee", "resources": { "hybrid": { "resources": { "issuers": { "methods": { "list": { "id": "apigee.hybrid.issuers.list", "flatPath": "v1/hybrid/issuers", "response": { "$ref": "GoogleCloudApigeeV1ListHybridIssuersResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "description": "Required. Must be of the form `hybrid/issuers`.", "pattern": "^hybrid/issuers$", "required": true, "location": "path", "type": "string" } }, "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." } } } } }, "projects": { "methods": { "provisionOrganization": { "flatPath": "v1/projects/{projectsId}:provisionOrganization", "id": "apigee.projects.provisionOrganization", "parameterOrder": [ "project" ], "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "project": { "description": "Required. Name of the GCP project with which to associate the Apigee organization.", "pattern": "^projects/[^/]+$", "type": "string", "location": "path", "required": true } }, "description": "Provisions a new Apigee organization with a functioning runtime. This is the standard way to create trial organizations for a free Apigee trial.", "httpMethod": "POST", "path": "v1/{+project}:provisionOrganization", "request": { "$ref": "GoogleCloudApigeeV1ProvisionOrganizationRequest" } } } }, "organizations": { "resources": { "sharedflows": { "methods": { "move": { "request": { "$ref": "GoogleCloudApigeeV1MoveSharedFlowRequest" }, "path": "v1/{+name}:move", "httpMethod": "POST", "parameters": { "name": { "description": "Required. Shared Flow to move in the following format: `organizations/{org}/sharedflows/{shared_flow}`", "pattern": "^organizations/[^/]+/sharedflows/[^/]+$", "location": "path", "type": "string", "required": true } }, "description": "Moves an shared flow to a different space.", "response": { "$ref": "GoogleCloudApigeeV1SharedFlow" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.sharedflows.move", "flatPath": "v1/organizations/{organizationsId}/sharedflows/{sharedflowsId}:move" }, "get": { "response": { "$ref": "GoogleCloudApigeeV1SharedFlow" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/sharedflows/{sharedflowsId}", "id": "apigee.organizations.sharedflows.get", "path": "v1/{+name}", "parameters": { "name": { "description": "Required. The name of the shared flow to get. Must be of the form: `organizations/{organization_id}/sharedflows/{shared_flow_id}` If the resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/sharedflows/[^/]+$", "type": "string", "location": "path", "required": true } }, "description": "Gets a shared flow by name, including a list of its revisions.", "httpMethod": "GET" }, "list": { "id": "apigee.organizations.sharedflows.list", "flatPath": "v1/organizations/{organizationsId}/sharedflows", "response": { "$ref": "GoogleCloudApigeeV1ListSharedFlowsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "path": "v1/{+parent}/sharedflows", "httpMethod": "GET", "parameters": { "parent": { "description": "Required. The name of the parent organization under which to get shared flows. Must be of the form: `organizations/{organization_id}` If the resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+$", "required": true, "location": "path", "type": "string" }, "includeMetaData": { "type": "boolean", "description": "Indicates whether to include shared flow metadata in the response.", "location": "query" }, "space": { "description": "Optional. The space ID used to filter the list of shared flows (optional). If unspecified, all shared flows in the organization will be listed. To learn how Spaces can be used to manage resources, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "location": "query", "type": "string" }, "includeRevisions": { "description": "Indicates whether to include a list of revisions in the response.", "location": "query", "type": "boolean" } }, "description": "Lists all shared flows in the organization. If the resource has the `space` attribute set, the response may not return all resources. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview)." }, "create": { "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1SharedFlowRevision" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.sharedflows.create", "flatPath": "v1/organizations/{organizationsId}/sharedflows", "request": { "$ref": "GoogleApiHttpBody" }, "httpMethod": "POST", "parameters": { "action": { "type": "string", "description": "Required. Must be set to either `import` or `validate`.", "location": "query" }, "name": { "type": "string", "description": "Required. The name to give the shared flow", "location": "query" }, "parent": { "required": true, "type": "string", "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}` If the resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+$" }, "space": { "description": "Optional. The ID of the space to associated with this shared flow. Any IAM policies applied to the space will affect access to this shared flow. Note that this field is only respected when creating a new shared flow. It has no effect when creating a new revision for an existing shared flow.", "location": "query", "type": "string" } }, "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.", "path": "v1/{+parent}/sharedflows" }, "delete": { "flatPath": "v1/organizations/{organizationsId}/sharedflows/{sharedflowsId}", "id": "apigee.organizations.sharedflows.delete", "response": { "$ref": "GoogleCloudApigeeV1SharedFlow" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}", "parameters": { "name": { "description": "Required. shared flow name of the form: `organizations/{organization_id}/sharedflows/{shared_flow_id}` If the resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/sharedflows/[^/]+$", "required": true, "location": "path", "type": "string" } }, "description": "Deletes a shared flow and all it's revisions. The shared flow must be undeployed before you can delete it.", "httpMethod": "DELETE" } }, "resources": { "revisions": { "methods": { "get": { "path": "v1/{+name}", "parameters": { "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}` If the Shared Flow resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/sharedflows/[^/]+/revisions/[^/]+$", "required": true, "location": "path", "type": "string" }, "format": { "description": "Specify `bundle` to export the contents of the shared flow bundle. Otherwise, the bundle metadata is returned.", "location": "query", "type": "string" } }, "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).", "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/sharedflows/{sharedflowsId}/revisions/{revisionsId}", "id": "apigee.organizations.sharedflows.revisions.get", "response": { "$ref": "GoogleApiHttpBody" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "delete": { "httpMethod": "DELETE", "parameters": { "name": { "type": "string", "location": "path", "required": true, "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}` If the Shared Flow resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/sharedflows/[^/]+/revisions/[^/]+$" } }, "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", "flatPath": "v1/organizations/{organizationsId}/sharedflows/{sharedflowsId}/revisions/{revisionsId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1SharedFlowRevision" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "updateSharedFlowRevision": { "request": { "$ref": "GoogleApiHttpBody" }, "path": "v1/{+name}", "httpMethod": "POST", "parameters": { "name": { "type": "string", "location": "path", "required": true, "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}` If the resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/sharedflows/[^/]+/revisions/[^/]+$" }, "validate": { "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", "type": "boolean" } }, "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.", "response": { "$ref": "GoogleCloudApigeeV1SharedFlowRevision" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.sharedflows.revisions.updateSharedFlowRevision", "flatPath": "v1/organizations/{organizationsId}/sharedflows/{sharedflowsId}/revisions/{revisionsId}" } }, "resources": { "deployments": { "methods": { "list": { "parameters": { "parent": { "type": "string", "location": "path", "required": true, "description": "Required. Name of the API proxy revision for which to return deployment information in the following format: `organizations/{org}/sharedflows/{sharedflow}/revisions/{rev}`. If the shared flow resource has the `space` attribute set, IAM permissions are checked differently . To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/sharedflows/[^/]+/revisions/[^/]+$" } }, "description": "Lists all deployments of a shared flow revision.", "httpMethod": "GET", "path": "v1/{+parent}/deployments", "flatPath": "v1/organizations/{organizationsId}/sharedflows/{sharedflowsId}/revisions/{revisionsId}/deployments", "id": "apigee.organizations.sharedflows.revisions.deployments.list", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ListDeploymentsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } } } }, "deployments": { "methods": { "list": { "id": "apigee.organizations.sharedflows.deployments.list", "flatPath": "v1/organizations/{organizationsId}/sharedflows/{sharedflowsId}/deployments", "response": { "$ref": "GoogleCloudApigeeV1ListDeploymentsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "path": "v1/{+parent}/deployments", "httpMethod": "GET", "parameters": { "parent": { "required": true, "location": "path", "type": "string", "description": "Required. Name of the shared flow for which to return deployment information in the following format: `organizations/{org}/sharedflows/{sharedflow}` If the shared flow resource has the `space` attribute set, IAM permissions are checked differently . To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/sharedflows/[^/]+$" } }, "description": "Lists all deployments of a shared flow." } } } } }, "hostQueries": { "methods": { "create": { "request": { "$ref": "GoogleCloudApigeeV1Query" }, "parameters": { "parent": { "type": "string", "location": "path", "required": true, "description": "Required. The parent resource name. Must be of the form `organizations/{org}`.", "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.", "httpMethod": "POST", "path": "v1/{+parent}/hostQueries", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1AsyncQuery" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/hostQueries", "id": "apigee.organizations.hostQueries.create" }, "list": { "parameters": { "submittedBy": { "type": "string", "description": "Filter response list by user who submitted queries.", "location": "query" }, "to": { "type": "string", "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" }, "parent": { "description": "Required. The parent resource name. Must be of the form `organizations/{org}`.", "pattern": "^organizations/[^/]+$", "type": "string", "location": "path", "required": true }, "status": { "type": "string", "description": "Filter response list by asynchronous query status.", "location": "query" }, "envgroupHostname": { "description": "Required. Filter response list by hostname.", "location": "query", "type": "string" }, "from": { "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'.", "location": "query", "type": "string" }, "dataset": { "type": "string", "description": "Filter response list by dataset. Example: `api`, `mint`", "location": "query" }, "inclQueriesWithoutReport": { "description": "Flag to include asynchronous queries that don't have a report denifition.", "location": "query", "type": "string" } }, "description": "Return a list of Asynchronous Queries at host level.", "httpMethod": "GET", "path": "v1/{+parent}/hostQueries", "flatPath": "v1/organizations/{organizationsId}/hostQueries", "id": "apigee.organizations.hostQueries.list", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ListAsyncQueriesResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "getResult": { "id": "apigee.organizations.hostQueries.getResult", "flatPath": "v1/organizations/{organizationsId}/hostQueries/{hostQueriesId}/result", "response": { "$ref": "GoogleApiHttpBody" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "description": "Required. Name of the asynchronous query result to get. Must be of the form `organizations/{org}/queries/{queryId}/result`.", "pattern": "^organizations/[^/]+/hostQueries/[^/]+/result$", "required": true, "type": "string", "location": "path" } }, "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`" }, "getResultView": { "flatPath": "v1/organizations/{organizationsId}/hostQueries/{hostQueriesId}/resultView", "id": "apigee.organizations.hostQueries.getResultView", "response": { "$ref": "GoogleCloudApigeeV1AsyncQueryResultView" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}", "parameters": { "name": { "description": "Required. Name of the asynchronous query result view to get. Must be of the form `organizations/{org}/queries/{queryId}/resultView`.", "pattern": "^organizations/[^/]+/hostQueries/[^/]+/resultView$", "required": true, "location": "path", "type": "string" } }, "description": "", "httpMethod": "GET" }, "get": { "response": { "$ref": "GoogleCloudApigeeV1AsyncQuery" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.hostQueries.get", "flatPath": "v1/organizations/{organizationsId}/hostQueries/{hostQueriesId}", "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "description": "Required. Name of the asynchronous query to get. Must be of the form `organizations/{org}/queries/{queryId}`.", "pattern": "^organizations/[^/]+/hostQueries/[^/]+$", "type": "string", "location": "path", "required": true } }, "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\"" } } }, "keyvaluemaps": { "resources": { "entries": { "methods": { "get": { "parameters": { "name": { "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}`. If the KeyValueMap is under an API Proxy resource that has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$", "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.", "httpMethod": "GET", "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}", "id": "apigee.organizations.keyvaluemaps.entries.get", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "update": { "path": "v1/{+name}", "parameters": { "name": { "required": true, "type": "string", "location": "path", "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}`. If the KeyValueMap is under an API Proxy resource that has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$" } }, "description": "Update key value entry scoped to an organization, environment, or API proxy for an existing key.", "httpMethod": "PUT", "request": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "flatPath": "v1/organizations/{organizationsId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}", "id": "apigee.organizations.keyvaluemaps.entries.update", "response": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "create": { "id": "apigee.organizations.keyvaluemaps.entries.create", "flatPath": "v1/organizations/{organizationsId}/keyvaluemaps/{keyvaluemapsId}/entries", "response": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "path": "v1/{+parent}/entries", "httpMethod": "POST", "parameters": { "parent": { "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}`. If the KeyValueMap is under an API Proxy resource that has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/keyvaluemaps/[^/]+$", "required": true, "location": "path", "type": "string" } }, "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.", "request": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" } }, "list": { "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ListKeyValueEntriesResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/keyvaluemaps/{keyvaluemapsId}/entries", "id": "apigee.organizations.keyvaluemaps.entries.list", "parameters": { "parent": { "required": true, "type": "string", "location": "path", "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}`. If the KeyValueMap is under an API Proxy resource that has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/keyvaluemaps/[^/]+$" }, "pageSize": { "description": "Optional. Maximum number of key value entries to return. If unspecified, at most 100 entries will be returned.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "type": "string", "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.", "location": "query" } }, "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", "path": "v1/{+parent}/entries" }, "delete": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}", "id": "apigee.organizations.keyvaluemaps.entries.delete", "parameters": { "name": { "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}`. If the KeyValueMap is under an API Proxy resource that has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$", "required": true, "type": "string", "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.", "httpMethod": "DELETE", "path": "v1/{+name}" } } } }, "methods": { "create": { "httpMethod": "POST", "parameters": { "parent": { "description": "Required. Name of the organization in which to create the key value map file. Use the following structure in your request: `organizations/{org}`", "pattern": "^organizations/[^/]+$", "required": true, "type": "string", "location": "path" } }, "description": "Creates a key value map in an organization.", "path": "v1/{+parent}/keyvaluemaps", "request": { "$ref": "GoogleCloudApigeeV1KeyValueMap" }, "id": "apigee.organizations.keyvaluemaps.create", "flatPath": "v1/organizations/{organizationsId}/keyvaluemaps", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1KeyValueMap" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "flatPath": "v1/organizations/{organizationsId}/keyvaluemaps/{keyvaluemapsId}", "id": "apigee.organizations.keyvaluemaps.delete", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1KeyValueMap" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "type": "string", "required": true, "description": "Required. Name of the key value map. Use the following structure in your request: `organizations/{org}/keyvaluemaps/{keyvaluemap}`", "pattern": "^organizations/[^/]+/keyvaluemaps/[^/]+$" } }, "description": "Deletes a key value map from an organization.", "httpMethod": "DELETE", "path": "v1/{+name}" }, "get": { "id": "apigee.organizations.keyvaluemaps.get", "flatPath": "v1/organizations/{organizationsId}/keyvaluemaps/{keyvaluemapsId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1KeyValueMap" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "name": { "description": "Required. Scope as indicated by the URI in which to fetch the key value map. 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}`. If the KeyValueMap is under an API Proxy resource that has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/keyvaluemaps/[^/]+$", "location": "path", "type": "string", "required": true } }, "description": "Get the key value map scoped to an organization, environment, or API proxy.", "path": "v1/{+name}" }, "update": { "parameters": { "name": { "description": "Required. Scope as indicated by the URI in which to fetch the key value map. 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}`. If the KeyValueMap is under an API Proxy resource that has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/keyvaluemaps/[^/]+$", "type": "string", "location": "path", "required": true } }, "description": "Update the key value map scoped to an organization, environment, or API proxy.", "httpMethod": "PUT", "path": "v1/{+name}", "request": { "$ref": "GoogleCloudApigeeV1KeyValueMap" }, "flatPath": "v1/organizations/{organizationsId}/keyvaluemaps/{keyvaluemapsId}", "id": "apigee.organizations.keyvaluemaps.update", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1KeyValueMap" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } }, "optimizedHostStats": { "methods": { "get": { "path": "v1/{+name}", "parameters": { "realtime": { "type": "boolean", "description": "No longer used by Apigee. Supported for backwards compatibility.", "location": "query" }, "limit": { "type": "string", "description": "Maximum number of result items to return.", "location": "query" }, "sortby": { "description": "Comma-separated list of metrics used to sort the final result.", "location": "query", "type": "string" }, "topk": { "type": "string", "description": "Top number of results to return. For example, to return the top 5 results, set `topk=5`.", "location": "query" }, "timeUnit": { "type": "string", "description": "Granularity of metrics returned. Valid values include: `second`, `minute`, `hour`, `day`, `week`, or `month`.", "location": "query" }, "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" }, "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" }, "select": { "description": "Required. Comma-separated list of metrics. For example: `sum(message_count),sum(error_count)`", "location": "query", "type": "string" }, "accuracy": { "type": "string", "description": "No longer used by Apigee. Supported for backwards compatibility.", "location": "query" }, "filter": { "description": "Filter that enables you to drill-down on specific dimension values.", "location": "query", "type": "string" }, "timeRange": { "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`.", "location": "query" }, "tzo": { "type": "string", "description": "Timezone offset value.", "location": "query" }, "name": { "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`", "pattern": "^organizations/[^/]+/optimizedHostStats/.*$", "required": true, "type": "string", "location": "path" }, "sort": { "type": "string", "description": "Flag that specifies whether the sort order should be ascending or descending. Valid values include `DESC` and `ASC`.", "location": "query" }, "envgroupHostname": { "type": "string", "description": "Required. Hostname for which the interactive query will be executed.", "location": "query" } }, "description": "Similar to GetHostStats except that the response is less verbose.", "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/optimizedHostStats/{optimizedHostStatsId}", "id": "apigee.organizations.optimizedHostStats.get", "response": { "$ref": "GoogleCloudApigeeV1OptimizedStats" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] } } }, "hostSecurityReports": { "methods": { "getResult": { "httpMethod": "GET", "parameters": { "name": { "description": "Required. Name of the security report result to get. Must be of the form `organizations/{org}/securityReports/{reportId}/result`.", "pattern": "^organizations/[^/]+/hostSecurityReports/[^/]+/result$", "required": true, "location": "path", "type": "string" } }, "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`", "path": "v1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleApiHttpBody" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.hostSecurityReports.getResult", "flatPath": "v1/organizations/{organizationsId}/hostSecurityReports/{hostSecurityReportsId}/result" }, "get": { "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "description": "Required. Name of the security report to get. Must be of the form `organizations/{org}/securityReports/{reportId}`.", "pattern": "^organizations/[^/]+/hostSecurityReports/[^/]+$", "type": "string", "location": "path", "required": true } }, "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\"", "id": "apigee.organizations.hostSecurityReports.get", "flatPath": "v1/organizations/{organizationsId}/hostSecurityReports/{hostSecurityReportsId}", "response": { "$ref": "GoogleCloudApigeeV1SecurityReport" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "getResultView": { "flatPath": "v1/organizations/{organizationsId}/hostSecurityReports/{hostSecurityReportsId}/resultView", "id": "apigee.organizations.hostSecurityReports.getResultView", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1SecurityReportResultView" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "type": "string", "required": true, "description": "Required. Name of the security report result view to get. Must be of the form `organizations/{org}/securityReports/{reportId}/resultView`.", "pattern": "^organizations/[^/]+/hostSecurityReports/[^/]+/resultView$" } }, "description": "After the query is completed, use this API to view the query result when result size is small.", "httpMethod": "GET", "path": "v1/{+name}" }, "create": { "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1SecurityReport" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.hostSecurityReports.create", "flatPath": "v1/organizations/{organizationsId}/hostSecurityReports", "request": { "$ref": "GoogleCloudApigeeV1SecurityReportQuery" }, "httpMethod": "POST", "parameters": { "parent": { "description": "Required. The parent resource name. Must be of the form `organizations/{org}`.", "pattern": "^organizations/[^/]+$", "required": true, "location": "path", "type": "string" } }, "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.", "path": "v1/{+parent}/hostSecurityReports" }, "list": { "flatPath": "v1/organizations/{organizationsId}/hostSecurityReports", "id": "apigee.organizations.hostSecurityReports.list", "response": { "$ref": "GoogleCloudApigeeV1ListSecurityReportsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "path": "v1/{+parent}/hostSecurityReports", "parameters": { "from": { "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'.", "location": "query" }, "dataset": { "type": "string", "description": "Filter response list by dataset. Example: `api`, `mint`", "location": "query" }, "pageSize": { "type": "integer", "description": "The maximum number of security report to return in the list response.", "location": "query", "format": "int32" }, "submittedBy": { "description": "Filter response list by user who submitted queries.", "location": "query", "type": "string" }, "pageToken": { "type": "string", "description": "Token returned from the previous list response to fetch the next page.", "location": "query" }, "status": { "description": "Filter response list by security report status.", "location": "query", "type": "string" }, "envgroupHostname": { "type": "string", "description": "Required. Filter response list by hostname.", "location": "query" }, "to": { "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'.", "location": "query" }, "parent": { "type": "string", "location": "path", "required": true, "description": "Required. The parent resource name. Must be of the form `organizations/{org}`.", "pattern": "^organizations/[^/]+$" } }, "description": "Return a list of Security Reports at host level.", "httpMethod": "GET" } } }, "securityMonitoringConditions": { "methods": { "create": { "path": "v1/{+parent}/securityMonitoringConditions", "httpMethod": "POST", "parameters": { "securityMonitoringConditionId": { "type": "string", "description": "Optional. Optional: The security monitoring condition id. If not specified, a monitoring condition uuid will be generated by the backend. This value should be 4-63 characters, and valid characters are /a-z-/.", "location": "query" }, "parent": { "required": true, "type": "string", "location": "path", "description": "Required. The parent resource name. Format: `organizations/{org}`", "pattern": "^organizations/[^/]+$" } }, "description": "Create a security monitoring condition.", "request": { "$ref": "GoogleCloudApigeeV1SecurityMonitoringCondition" }, "id": "apigee.organizations.securityMonitoringConditions.create", "flatPath": "v1/organizations/{organizationsId}/securityMonitoringConditions", "response": { "$ref": "GoogleCloudApigeeV1SecurityMonitoringCondition" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ] }, "list": { "path": "v1/{+parent}/securityMonitoringConditions", "httpMethod": "GET", "parameters": { "filter": { "description": "Optional. Filter for the monitoring conditions. When RiskAssessmentType is APIGEE, monitoring conditions can be filtered by profile and scope. For example: `profile=profile1 AND scope=env1` When RiskAssessmentType is API_HUB, monitoring conditions can be filtered by profile and api_hub_gateway. For example: `profile=profile1 AND api_hub_gateway=gateway1`", "location": "query", "type": "string" }, "pageToken": { "description": "Optional. A page token, received from a previous `ListSecurityMonitoringConditions` call. Provide this to retrieve the subsequent page.", "location": "query", "type": "string" }, "pageSize": { "format": "int32", "description": "Optional. The maximum number of monitoring conditions to return.", "location": "query", "type": "integer" }, "parent": { "type": "string", "location": "path", "required": true, "description": "Required. For a specific organization, list all the security monitoring conditions. Format: `organizations/{org}`", "pattern": "^organizations/[^/]+$" }, "riskAssessmentType": { "type": "string", "location": "query", "enum": [ "RISK_ASSESSMENT_TYPE_UNSPECIFIED", "APIGEE", "API_HUB" ], "description": "Optional. The risk assessment type of the security monitoring condition. Defaults to ADVANCED_API_SECURITY.", "enumDescriptions": [ "Risk assessment type is not specified.", "Risk assessment type is Apigee.", "Risk assessment type is API Hub." ] } }, "description": "List security monitoring conditions.", "id": "apigee.organizations.securityMonitoringConditions.list", "flatPath": "v1/organizations/{organizationsId}/securityMonitoringConditions", "response": { "$ref": "GoogleCloudApigeeV1ListSecurityMonitoringConditionsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ] }, "delete": { "httpMethod": "DELETE", "parameters": { "name": { "description": "Required. The name of the security monitoring condition to delete. Format: `organizations/{org}/securityMonitoringConditions/{security_monitoring_condition}`", "pattern": "^organizations/[^/]+/securityMonitoringConditions/[^/]+$", "required": true, "type": "string", "location": "path" }, "riskAssessmentType": { "description": "Optional. The risk assessment type of the security monitoring condition. Defaults to ADVANCED_API_SECURITY.", "enumDescriptions": [ "Risk assessment type is not specified.", "Risk assessment type is Apigee.", "Risk assessment type is API Hub." ], "location": "query", "enum": [ "RISK_ASSESSMENT_TYPE_UNSPECIFIED", "APIGEE", "API_HUB" ], "type": "string" } }, "description": "Delete a security monitoring condition.", "path": "v1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.securityMonitoringConditions.delete", "flatPath": "v1/organizations/{organizationsId}/securityMonitoringConditions/{securityMonitoringConditionsId}" }, "patch": { "id": "apigee.organizations.securityMonitoringConditions.patch", "flatPath": "v1/organizations/{organizationsId}/securityMonitoringConditions/{securityMonitoringConditionsId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1SecurityMonitoringCondition" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "PATCH", "parameters": { "name": { "description": "Identifier. Name of the security monitoring condition resource. Format: organizations/{org}/securityMonitoringConditions/{security_monitoring_condition}", "pattern": "^organizations/[^/]+/securityMonitoringConditions/[^/]+$", "type": "string", "location": "path", "required": true }, "updateMask": { "format": "google-fieldmask", "type": "string", "description": "Optional. The list of fields to update. Valid fields to update are `include_all_resources` and `include`.", "location": "query" } }, "description": "Update a security monitoring condition.", "path": "v1/{+name}", "request": { "$ref": "GoogleCloudApigeeV1SecurityMonitoringCondition" } }, "get": { "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. The name of the security monitoring condition to get. Format: `organizations/{org}/securityMonitoringConditions/{security_monitoring_condition}`", "pattern": "^organizations/[^/]+/securityMonitoringConditions/[^/]+$" }, "riskAssessmentType": { "description": "Optional. The risk assessment type of the security monitoring condition. Defaults to ADVANCED_API_SECURITY.", "enumDescriptions": [ "Risk assessment type is not specified.", "Risk assessment type is Apigee.", "Risk assessment type is API Hub." ], "type": "string", "location": "query", "enum": [ "RISK_ASSESSMENT_TYPE_UNSPECIFIED", "APIGEE", "API_HUB" ] } }, "description": "Get a security monitoring condition.", "id": "apigee.organizations.securityMonitoringConditions.get", "flatPath": "v1/organizations/{organizationsId}/securityMonitoringConditions/{securityMonitoringConditionsId}", "response": { "$ref": "GoogleCloudApigeeV1SecurityMonitoringCondition" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] } } }, "operations": { "methods": { "list": { "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/operations", "id": "apigee.organizations.operations.list", "path": "v1/{+name}/operations", "parameters": { "pageSize": { "type": "integer", "description": "The standard list page size.", "location": "query", "format": "int32" }, "name": { "description": "The name of the operation's parent resource.", "pattern": "^organizations/[^/]+$", "type": "string", "location": "path", "required": true }, "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" }, "filter": { "type": "string", "description": "The standard list filter.", "location": "query" } }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "httpMethod": "GET" }, "get": { "parameters": { "name": { "description": "The name of the operation resource.", "pattern": "^organizations/[^/]+/operations/[^/]+$", "location": "path", "type": "string", "required": true } }, "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.", "httpMethod": "GET", "path": "v1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/operations/{operationsId}", "id": "apigee.organizations.operations.get" } } }, "apimServiceExtensions": { "methods": { "get": { "httpMethod": "GET", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. Name of the service extension. Use the following structure in your request: `organizations/{org}/apimServiceExtensions/{extension_id}`", "pattern": "^organizations/[^/]+/apimServiceExtensions/[^/]+$" } }, "description": "Gets APIM service extension details.", "path": "v1/{+name}", "id": "apigee.organizations.apimServiceExtensions.get", "flatPath": "v1/organizations/{organizationsId}/apimServiceExtensions/{apimServiceExtensionsId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1ApimServiceExtension" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "patch": { "request": { "$ref": "GoogleCloudApigeeV1ApimServiceExtension" }, "httpMethod": "PATCH", "parameters": { "allowMissing": { "type": "boolean", "description": "Optional. If set to true, and the service extension is not found, a new service extension will be created. In this situation, `update_mask` is ignored.", "location": "query" }, "updateMask": { "format": "google-fieldmask", "type": "string", "description": "Optional. The list of fields to update.", "location": "query" }, "name": { "required": true, "location": "path", "type": "string", "description": "Identifier. unique name of the APIM service extension. The name must conform with RFC-1034, is restricted to lower-cased letters, numbers and hyphens, and can have a maximum length of 63 characters. Additionally, the first character must be a letter and the last a letter or a number.", "pattern": "^organizations/[^/]+/apimServiceExtensions/[^/]+$" } }, "description": "Updates an APIM service extension in an organization.", "path": "v1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.apimServiceExtensions.patch", "flatPath": "v1/organizations/{organizationsId}/apimServiceExtensions/{apimServiceExtensionsId}" }, "delete": { "path": "v1/{+name}", "parameters": { "name": { "required": true, "location": "path", "type": "string", "description": "Required. Name of the service extension. Use the following structure in your request: `organizations/{org}/apimServiceExtensions/{extension_id}`", "pattern": "^organizations/[^/]+/apimServiceExtensions/[^/]+$" } }, "description": "Deletes APIM service extension from an organization.", "httpMethod": "DELETE", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/apimServiceExtensions/{apimServiceExtensionsId}", "id": "apigee.organizations.apimServiceExtensions.delete" }, "create": { "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.apimServiceExtensions.create", "flatPath": "v1/organizations/{organizationsId}/apimServiceExtensions", "request": { "$ref": "GoogleCloudApigeeV1ApimServiceExtension" }, "httpMethod": "POST", "parameters": { "parent": { "type": "string", "location": "path", "required": true, "description": "Required. Name of the organization in which the service extension will be created. Use the following structure in your request: `organizations/{org}`", "pattern": "^organizations/[^/]+$" }, "apimServiceExtensionId": { "description": "Optional. ID used to uniquely identify of the service extension. It must conform with RFC-1034, is restricted to lower-cased letters, numbers and hyphens, and can have a maximum length of 63 characters. Additionally, the first character must be a letter and the last a letter or a number.", "location": "query", "type": "string" } }, "description": "Creates an APIM ServiceExtension in an organization.", "path": "v1/{+parent}/apimServiceExtensions" }, "list": { "path": "v1/{+parent}/apimServiceExtensions", "parameters": { "pageSize": { "format": "int32", "description": "Optional. Maximum number of items to return. If unspecified, at most 25 service extension will be returned.", "location": "query", "type": "integer" }, "pageToken": { "description": "Optional. Page token, returned from a previous `ListApimServiceExtensions` call, that you can use to retrieve the next page.", "location": "query", "type": "string" }, "parent": { "description": "Required. Name of the organization for which to list the service extension. Use the following structure in your request: `organizations/{org}/apimServiceExtensions`", "pattern": "^organizations/[^/]+$", "location": "path", "type": "string", "required": true } }, "description": "Lists all APIM service extensions in an organization.", "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/apimServiceExtensions", "id": "apigee.organizations.apimServiceExtensions.list", "response": { "$ref": "GoogleCloudApigeeV1ListApimServiceExtensionsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ] } } }, "deployments": { "methods": { "list": { "path": "v1/{+parent}/deployments", "parameters": { "parent": { "description": "Required. Name of the organization for which to return deployment information in the following format: `organizations/{org}`", "pattern": "^organizations/[^/]+$", "required": true, "location": "path", "type": "string" }, "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" } }, "description": "Lists all deployments of API proxies or shared flows.", "httpMethod": "GET", "response": { "$ref": "GoogleCloudApigeeV1ListDeploymentsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "flatPath": "v1/organizations/{organizationsId}/deployments", "id": "apigee.organizations.deployments.list" } } }, "analytics": { "resources": { "datastores": { "methods": { "delete": { "path": "v1/{+name}", "parameters": { "name": { "description": "Required. Resource name of the Datastore to be deleted. Must be of the form `organizations/{org}/analytics/datastores/{datastoreId}`", "pattern": "^organizations/[^/]+/analytics/datastores/[^/]+$", "required": true, "location": "path", "type": "string" } }, "description": "Delete a Datastore from an org.", "httpMethod": "DELETE", "flatPath": "v1/organizations/{organizationsId}/analytics/datastores/{datastoresId}", "id": "apigee.organizations.analytics.datastores.delete", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "create": { "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1Datastore" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/analytics/datastores", "id": "apigee.organizations.analytics.datastores.create", "request": { "$ref": "GoogleCloudApigeeV1Datastore" }, "parameters": { "parent": { "description": "Required. The parent organization name. Must be of the form `organizations/{org}`.", "pattern": "^organizations/[^/]+$", "required": true, "type": "string", "location": "path" } }, "description": "Create a Datastore for an org", "httpMethod": "POST", "path": "v1/{+parent}/analytics/datastores" }, "list": { "response": { "$ref": "GoogleCloudApigeeV1ListDatastoresResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "id": "apigee.organizations.analytics.datastores.list", "flatPath": "v1/organizations/{organizationsId}/analytics/datastores", "path": "v1/{+parent}/analytics/datastores", "httpMethod": "GET", "parameters": { "parent": { "description": "Required. The parent organization name. Must be of the form `organizations/{org}`.", "pattern": "^organizations/[^/]+$", "location": "path", "type": "string", "required": true }, "targetType": { "description": "Optional. TargetType is used to fetch all Datastores that match the type", "location": "query", "type": "string" } }, "description": "List Datastores" }, "get": { "id": "apigee.organizations.analytics.datastores.get", "flatPath": "v1/organizations/{organizationsId}/analytics/datastores/{datastoresId}", "response": { "$ref": "GoogleCloudApigeeV1Datastore" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "description": "Required. Resource name of the Datastore to be get. Must be of the form `organizations/{org}/analytics/datastores/{datastoreId}`", "pattern": "^organizations/[^/]+/analytics/datastores/[^/]+$", "type": "string", "location": "path", "required": true } }, "description": "Get a Datastore" }, "update": { "path": "v1/{+name}", "parameters": { "name": { "location": "path", "type": "string", "required": true, "description": "Required. The resource name of datastore to be updated. Must be of the form `organizations/{org}/analytics/datastores/{datastoreId}`", "pattern": "^organizations/[^/]+/analytics/datastores/[^/]+$" } }, "description": "Update a Datastore", "httpMethod": "PUT", "request": { "$ref": "GoogleCloudApigeeV1Datastore" }, "flatPath": "v1/organizations/{organizationsId}/analytics/datastores/{datastoresId}", "id": "apigee.organizations.analytics.datastores.update", "response": { "$ref": "GoogleCloudApigeeV1Datastore" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "test": { "flatPath": "v1/organizations/{organizationsId}/analytics/datastores:test", "id": "apigee.organizations.analytics.datastores.test", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1TestDatastoreResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "required": true, "type": "string", "location": "path", "description": "Required. The parent organization name Must be of the form `organizations/{org}`", "pattern": "^organizations/[^/]+$" } }, "description": "Test if Datastore configuration is correct. This includes checking if credentials provided by customer have required permissions in target destination storage", "httpMethod": "POST", "path": "v1/{+parent}/analytics/datastores:test", "request": { "$ref": "GoogleCloudApigeeV1Datastore" } } } } } }, "securityAssessmentResults": { "methods": { "batchCompute": { "request": { "$ref": "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequest" }, "path": "v1/{+name}:batchCompute", "httpMethod": "POST", "parameters": { "name": { "description": "Required. Name of the organization for which the score needs to be computed in the following format: `organizations/{org}/securityAssessmentResults`", "pattern": "^organizations/[^/]+/securityAssessmentResults$", "required": true, "type": "string", "location": "path" } }, "description": "Compute RAV2 security scores for a set of resources.", "response": { "$ref": "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.securityAssessmentResults.batchCompute", "flatPath": "v1/organizations/{organizationsId}/securityAssessmentResults:batchCompute" } } }, "securityFeedback": { "methods": { "get": { "httpMethod": "GET", "parameters": { "name": { "description": "Required. Name of the SecurityFeedback. Format: `organizations/{org}/securityFeedback/{feedback_id}` Example: organizations/apigee-organization-name/securityFeedback/feedback-id", "pattern": "^organizations/[^/]+/securityFeedback/[^/]+$", "required": true, "location": "path", "type": "string" } }, "description": "Gets a specific customer feedback report.", "path": "v1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1SecurityFeedback" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.securityFeedback.get", "flatPath": "v1/organizations/{organizationsId}/securityFeedback/{securityFeedbackId}" }, "patch": { "request": { "$ref": "GoogleCloudApigeeV1SecurityFeedback" }, "path": "v1/{+name}", "httpMethod": "PATCH", "parameters": { "name": { "location": "path", "type": "string", "required": true, "description": "Output only. Identifier. The feedback name is intended to be a system-generated uuid.", "pattern": "^organizations/[^/]+/securityFeedback/[^/]+$" }, "updateMask": { "type": "string", "description": "Optional. The list of fields to update.", "location": "query", "format": "google-fieldmask" } }, "description": "Updates a specific feedback report.", "response": { "$ref": "GoogleCloudApigeeV1SecurityFeedback" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.securityFeedback.patch", "flatPath": "v1/organizations/{organizationsId}/securityFeedback/{securityFeedbackId}" }, "delete": { "id": "apigee.organizations.securityFeedback.delete", "flatPath": "v1/organizations/{organizationsId}/securityFeedback/{securityFeedbackId}", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "DELETE", "parameters": { "name": { "description": "Required. Name of the SecurityFeedback to delete. Use the following structure in your request: `organizations/{org}/securityFeedback/{feedback_id}`", "pattern": "^organizations/[^/]+/securityFeedback/[^/]+$", "type": "string", "location": "path", "required": true } }, "description": "Deletes a specific feedback report. Used for \"undo\" of a feedback submission." }, "create": { "request": { "$ref": "GoogleCloudApigeeV1SecurityFeedback" }, "httpMethod": "POST", "parameters": { "parent": { "description": "Required. Name of the organization. Use the following structure in your request: `organizations/{org}`.", "pattern": "^organizations/[^/]+$", "location": "path", "type": "string", "required": true }, "securityFeedbackId": { "description": "Optional. The id for this feedback report. If not provided, it will be set to a system-generated UUID.", "location": "query", "type": "string" } }, "description": "Creates a new report containing customer feedback.", "path": "v1/{+parent}/securityFeedback", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1SecurityFeedback" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.securityFeedback.create", "flatPath": "v1/organizations/{organizationsId}/securityFeedback" }, "list": { "flatPath": "v1/organizations/{organizationsId}/securityFeedback", "id": "apigee.organizations.securityFeedback.list", "response": { "$ref": "GoogleCloudApigeeV1ListSecurityFeedbackResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "path": "v1/{+parent}/securityFeedback", "parameters": { "pageSize": { "format": "int32", "type": "integer", "description": "Optional. The maximum number of feedback reports to return. The service may return fewer than this value. LINT.IfChange(documented_page_size_limits) If unspecified, at most 10 feedback reports will be returned. The maximum value is 100; values above 100 will be coerced to 100. LINT.ThenChange( //depot/google3/edge/sense/boq/service/v1/securityfeedback/securityfeedback_rpc.go:page_size_limits )", "location": "query" }, "pageToken": { "description": "Optional. A page token, received from a previous `ListSecurityFeedback` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListSecurityFeedback` must match the call that provided the page token.", "location": "query", "type": "string" }, "parent": { "location": "path", "type": "string", "required": true, "description": "Required. Name of the organization. Format: `organizations/{org}`. Example: organizations/apigee-organization-name/securityFeedback", "pattern": "^organizations/[^/]+$" } }, "description": "Lists all feedback reports which have already been submitted.", "httpMethod": "GET" } } }, "spaces": { "methods": { "patch": { "id": "apigee.organizations.spaces.patch", "flatPath": "v1/organizations/{organizationsId}/spaces/{spacesId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1Space" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "PATCH", "parameters": { "name": { "required": true, "location": "path", "type": "string", "description": "Required. Name of the space in the following format: `organizations/{org}/spaces/{space_id}`.", "pattern": "^organizations/[^/]+/spaces/[^/]+$" }, "updateMask": { "format": "google-fieldmask", "description": "Required. List of fields to be updated. Fields that can be updated: display_name.", "location": "query", "type": "string" } }, "description": "Updates a space.", "path": "v1/{+name}", "request": { "$ref": "GoogleCloudApigeeV1Space" } }, "setIamPolicy": { "request": { "$ref": "GoogleIamV1SetIamPolicyRequest" }, "parameters": { "resource": { "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/[^/]+/spaces/[^/]+$", "location": "path", "type": "string", "required": true } }, "description": "IAM META APIs Callers must have apigee.spaces.setIamPolicy.", "httpMethod": "POST", "path": "v1/{+resource}:setIamPolicy", "parameterOrder": [ "resource" ], "response": { "$ref": "GoogleIamV1Policy" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/spaces/{spacesId}:setIamPolicy", "id": "apigee.organizations.spaces.setIamPolicy" }, "get": { "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Required. Apigee organization space name in the following format: `organizations/{org}/spaces/{space}`", "pattern": "^organizations/[^/]+/spaces/[^/]+$" } }, "description": "Get a space under an Organization.", "httpMethod": "GET", "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/spaces/{spacesId}", "id": "apigee.organizations.spaces.get", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1Space" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "testIamPermissions": { "request": { "$ref": "GoogleIamV1TestIamPermissionsRequest" }, "httpMethod": "POST", "parameters": { "resource": { "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.", "pattern": "^organizations/[^/]+/spaces/[^/]+$", "type": "string", "location": "path", "required": true } }, "description": "Callers don't need any permissions.", "path": "v1/{+resource}:testIamPermissions", "parameterOrder": [ "resource" ], "response": { "$ref": "GoogleIamV1TestIamPermissionsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.spaces.testIamPermissions", "flatPath": "v1/organizations/{organizationsId}/spaces/{spacesId}:testIamPermissions" }, "create": { "request": { "$ref": "GoogleCloudApigeeV1Space" }, "parameters": { "spaceId": { "type": "string", "description": "Required. Resource ID of the space.", "location": "query" }, "parent": { "location": "path", "type": "string", "required": true, "description": "Required. Name of the Google Cloud project in which to associate the Apigee space. Pass the information as a query parameter using the following structure in your request: `organizations/`", "pattern": "^organizations/[^/]+$" } }, "description": "Create a space under an organization.", "httpMethod": "POST", "path": "v1/{+parent}/spaces", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1Space" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/spaces", "id": "apigee.organizations.spaces.create" }, "list": { "parameters": { "parent": { "description": "Required. Use the following structure in your request: `organizations`", "pattern": "^organizations/[^/]+$", "required": true, "location": "path", "type": "string" }, "pageSize": { "type": "integer", "description": "Optional. The maximum number of spaces to return. The service may return fewer than this value. If unspecified, at most 50 spaces will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", "location": "query", "format": "int32" }, "pageToken": { "type": "string", "description": "Optional. A page token, received from a previous `ListSpaces` call. Provide this to retrieve the subsequent page. When paginating, all parameters must match the original call.", "location": "query" } }, "description": "Lists spaces under an organization.", "httpMethod": "GET", "path": "v1/{+parent}/spaces", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ListSpacesResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/spaces", "id": "apigee.organizations.spaces.list" }, "getIamPolicy": { "parameterOrder": [ "resource" ], "response": { "$ref": "GoogleIamV1Policy" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.spaces.getIamPolicy", "flatPath": "v1/organizations/{organizationsId}/spaces/{spacesId}:getIamPolicy", "httpMethod": "GET", "parameters": { "resource": { "required": true, "location": "path", "type": "string", "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.", "pattern": "^organizations/[^/]+/spaces/[^/]+$" }, "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" } }, "description": "Callers must have apigee.spaces.getIamPolicy.", "path": "v1/{+resource}:getIamPolicy" }, "delete": { "path": "v1/{+name}", "parameters": { "name": { "description": "Required. Apigee organization space name in the following format: `organizations/{org}/spaces/{space}`", "pattern": "^organizations/[^/]+/spaces/[^/]+$", "location": "path", "type": "string", "required": true } }, "description": "Deletes an organization space.", "httpMethod": "DELETE", "flatPath": "v1/organizations/{organizationsId}/spaces/{spacesId}", "id": "apigee.organizations.spaces.delete", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] } } }, "hostStats": { "methods": { "get": { "parameters": { "realtime": { "type": "boolean", "description": "No longer used by Apigee. Supported for backwards compatibility.", "location": "query" }, "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" }, "tsAscending": { "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", "type": "boolean" }, "limit": { "description": "Maximum number of result items to return.", "location": "query", "type": "string" }, "sortby": { "type": "string", "description": "Comma-separated list of metrics to sort the final result.", "location": "query" }, "topk": { "description": "Top number of results to return. For example, to return the top 5 results, set `topk=5`.", "location": "query", "type": "string" }, "timeUnit": { "description": "Granularity of metrics returned. Valid values include: `second`, `minute`, `hour`, `day`, `week`, or `month`.", "location": "query", "type": "string" }, "filter": { "type": "string", "description": "Flag that enables drill-down on specific dimension values.", "location": "query" }, "select": { "type": "string", "description": "Comma-separated list of metrics. For example: `sum(message_count),sum(error_count)`", "location": "query" }, "accuracy": { "type": "string", "description": "No longer used by Apigee. Supported for backwards compatibility.", "location": "query" }, "envgroupHostname": { "description": "Required. Hostname for which the interactive query will be executed.", "location": "query", "type": "string" }, "timeRange": { "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`", "location": "query" }, "tzo": { "type": "string", "description": "Timezone offset value.", "location": "query" }, "name": { "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`", "pattern": "^organizations/[^/]+/hostStats/.*$", "required": true, "location": "path", "type": "string" }, "sort": { "description": "Flag that specifies if the sort order should be ascending or descending. Valid values are `DESC` and `ASC`.", "location": "query", "type": "string" } }, "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.", "httpMethod": "GET", "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/hostStats/{hostStatsId}", "id": "apigee.organizations.hostStats.get", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1Stats" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } }, "securityProfiles": { "resources": { "environments": { "methods": { "delete": { "path": "v1/{+name}", "parameters": { "name": { "location": "path", "type": "string", "required": true, "description": "Required. The name of the environment attachment to delete. Format: organizations/{org}/securityProfiles/{profile}/environments/{env}", "pattern": "^organizations/[^/]+/securityProfiles/[^/]+/environments/[^/]+$" } }, "description": "DeleteSecurityProfileEnvironmentAssociation removes profile environment association i.e. detaches environment from security profile.", "httpMethod": "DELETE", "flatPath": "v1/organizations/{organizationsId}/securityProfiles/{securityProfilesId}/environments/{environmentsId}", "id": "apigee.organizations.securityProfiles.environments.delete", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "computeEnvironmentScores": { "request": { "$ref": "GoogleCloudApigeeV1ComputeEnvironmentScoresRequest" }, "parameters": { "profileEnvironment": { "description": "Required. Name of organization and environment and profile id for which score needs to be computed. Format: organizations/{org}/securityProfiles/{profile}/environments/{env}", "pattern": "^organizations/[^/]+/securityProfiles/[^/]+/environments/[^/]+$", "location": "path", "type": "string", "required": true } }, "description": "ComputeEnvironmentScores calculates scores for requested time range for the specified security profile and environment.", "httpMethod": "POST", "path": "v1/{+profileEnvironment}:computeEnvironmentScores", "parameterOrder": [ "profileEnvironment" ], "response": { "$ref": "GoogleCloudApigeeV1ComputeEnvironmentScoresResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/securityProfiles/{securityProfilesId}/environments/{environmentsId}:computeEnvironmentScores", "id": "apigee.organizations.securityProfiles.environments.computeEnvironmentScores" }, "create": { "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1SecurityProfileEnvironmentAssociation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/securityProfiles/{securityProfilesId}/environments", "id": "apigee.organizations.securityProfiles.environments.create", "request": { "$ref": "GoogleCloudApigeeV1SecurityProfileEnvironmentAssociation" }, "parameters": { "parent": { "required": true, "location": "path", "type": "string", "description": "Required. Name of organization and security profile ID. Format: organizations/{org}/securityProfiles/{profile}", "pattern": "^organizations/[^/]+/securityProfiles/[^/]+$" } }, "description": "CreateSecurityProfileEnvironmentAssociation creates profile environment association i.e. attaches environment to security profile.", "httpMethod": "POST", "path": "v1/{+parent}/environments" } } } }, "methods": { "create": { "request": { "$ref": "GoogleCloudApigeeV1SecurityProfile" }, "parameters": { "securityProfileId": { "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])?$)\".", "location": "query" }, "parent": { "location": "path", "type": "string", "required": true, "description": "Required. Name of organization. Format: organizations/{org}", "pattern": "^organizations/[^/]+$" } }, "description": "CreateSecurityProfile create a new custom security profile.", "httpMethod": "POST", "path": "v1/{+parent}/securityProfiles", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1SecurityProfile" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/securityProfiles", "id": "apigee.organizations.securityProfiles.create" }, "list": { "id": "apigee.organizations.securityProfiles.list", "flatPath": "v1/organizations/{organizationsId}/securityProfiles", "response": { "$ref": "GoogleCloudApigeeV1ListSecurityProfilesResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "path": "v1/{+parent}/securityProfiles", "httpMethod": "GET", "parameters": { "pageSize": { "format": "int32", "type": "integer", "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.", "location": "query" }, "pageToken": { "type": "string", "description": "A page token, received from a previous `ListSecurityProfiles` call. Provide this to retrieve the subsequent page.", "location": "query" }, "parent": { "type": "string", "location": "path", "required": true, "description": "Required. For a specific organization, list of all the security profiles. Format: `organizations/{org}`", "pattern": "^organizations/[^/]+$" } }, "description": "ListSecurityProfiles lists all the security profiles associated with the org including attached and unattached profiles." }, "listRevisions": { "httpMethod": "GET", "parameters": { "pageSize": { "format": "int32", "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.", "location": "query", "type": "integer" }, "pageToken": { "description": "A page token, received from a previous `ListSecurityProfileRevisions` call. Provide this to retrieve the subsequent page.", "location": "query", "type": "string" }, "name": { "location": "path", "type": "string", "required": true, "description": "Required. For a specific profile, list all the revisions. Format: `organizations/{org}/securityProfiles/{profile}`", "pattern": "^organizations/[^/]+/securityProfiles/[^/]+$" } }, "description": "ListSecurityProfileRevisions lists all the revisions of the security profile.", "path": "v1/{+name}:listRevisions", "id": "apigee.organizations.securityProfiles.listRevisions", "flatPath": "v1/organizations/{organizationsId}/securityProfiles/{securityProfilesId}:listRevisions", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1ListSecurityProfileRevisionsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "id": "apigee.organizations.securityProfiles.delete", "flatPath": "v1/organizations/{organizationsId}/securityProfiles/{securityProfilesId}", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "DELETE", "parameters": { "name": { "required": true, "location": "path", "type": "string", "description": "Required. Name of profile. Format: organizations/{org}/securityProfiles/{profile}", "pattern": "^organizations/[^/]+/securityProfiles/[^/]+$" } }, "description": "DeleteSecurityProfile delete a profile with all its revisions." }, "patch": { "flatPath": "v1/organizations/{organizationsId}/securityProfiles/{securityProfilesId}", "id": "apigee.organizations.securityProfiles.patch", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1SecurityProfile" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "Immutable. Name of the security profile resource. Format: organizations/{org}/securityProfiles/{profile}", "pattern": "^organizations/[^/]+/securityProfiles/[^/]+$", "location": "path", "type": "string", "required": true }, "updateMask": { "format": "google-fieldmask", "type": "string", "description": "Required. The list of fields to update.", "location": "query" } }, "description": "UpdateSecurityProfile update the metadata of security profile.", "httpMethod": "PATCH", "path": "v1/{+name}", "request": { "$ref": "GoogleCloudApigeeV1SecurityProfile" } }, "get": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1SecurityProfile" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/securityProfiles/{securityProfilesId}", "id": "apigee.organizations.securityProfiles.get", "parameters": { "name": { "type": "string", "location": "path", "required": true, "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", "pattern": "^organizations/[^/]+/securityProfiles/[^/]+$" } }, "description": "GetSecurityProfile gets the specified security profile. Returns NOT_FOUND if security profile is not present for the specified organization.", "httpMethod": "GET", "path": "v1/{+name}" } } }, "sites": { "resources": { "apidocs": { "methods": { "get": { "httpMethod": "GET", "parameters": { "name": { "description": "Required. Name of the catalog item. Use the following structure in your request: `organizations/{org}/sites/{site}/apidocs/{apidoc}`", "pattern": "^organizations/[^/]+/sites/[^/]+/apidocs/[^/]+$", "required": true, "location": "path", "type": "string" } }, "description": "Gets a catalog item.", "path": "v1/{+name}", "id": "apigee.organizations.sites.apidocs.get", "flatPath": "v1/organizations/{organizationsId}/sites/{sitesId}/apidocs/{apidocsId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1ApiDocResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "update": { "request": { "$ref": "GoogleCloudApigeeV1ApiDoc" }, "httpMethod": "PUT", "parameters": { "name": { "description": "Required. Name of the catalog item. Use the following structure in your request: `organizations/{org}/sites/{site}/apidocs/{apidoc}`", "pattern": "^organizations/[^/]+/sites/[^/]+/apidocs/[^/]+$", "location": "path", "type": "string", "required": true } }, "description": "Updates a catalog item.", "path": "v1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1ApiDocResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.sites.apidocs.update", "flatPath": "v1/organizations/{organizationsId}/sites/{sitesId}/apidocs/{apidocsId}" }, "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`", "pattern": "^organizations/[^/]+/sites/[^/]+/apidocs/[^/]+/documentation$", "location": "path", "type": "string", "required": true } }, "description": "Gets the documentation for the specified catalog item.", "httpMethod": "GET", "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/sites/{sitesId}/apidocs/{apidocsId}/documentation", "id": "apigee.organizations.sites.apidocs.getDocumentation", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1ApiDocDocumentationResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "create": { "parameters": { "parent": { "required": true, "type": "string", "location": "path", "description": "Required. Name of the portal. Use the following structure in your request: `organizations/{org}/sites/{site}`", "pattern": "^organizations/[^/]+/sites/[^/]+$" } }, "description": "Creates a new catalog item.", "httpMethod": "POST", "path": "v1/{+parent}/apidocs", "request": { "$ref": "GoogleCloudApigeeV1ApiDoc" }, "flatPath": "v1/organizations/{organizationsId}/sites/{sitesId}/apidocs", "id": "apigee.organizations.sites.apidocs.create", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ApiDocResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "path": "v1/{+parent}/apidocs", "parameters": { "pageSize": { "format": "int32", "type": "integer", "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.", "location": "query" }, "pageToken": { "description": "Optional. A page token, received from a previous `ListApiDocs` call. Provide this to retrieve the subsequent page.", "location": "query", "type": "string" }, "parent": { "description": "Required. Name of the portal. Use the following structure in your request: `organizations/{org}/sites/{site}`", "pattern": "^organizations/[^/]+/sites/[^/]+$", "type": "string", "location": "path", "required": true } }, "description": "Returns the catalog items associated with a portal.", "httpMethod": "GET", "response": { "$ref": "GoogleCloudApigeeV1ListApiDocsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "flatPath": "v1/organizations/{organizationsId}/sites/{sitesId}/apidocs", "id": "apigee.organizations.sites.apidocs.list" }, "updateDocumentation": { "request": { "$ref": "GoogleCloudApigeeV1ApiDocDocumentation" }, "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. Resource name of the catalog item documentation. Use the following structure in your request: `organizations/{org}/sites/{site}/apidocs/{apidoc}/documentation`", "pattern": "^organizations/[^/]+/sites/[^/]+/apidocs/[^/]+/documentation$" } }, "description": "Updates the documentation for the specified catalog item. Note that the documentation file contents will not be populated in the return message.", "httpMethod": "PATCH", "path": "v1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1ApiDocDocumentationResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/sites/{sitesId}/apidocs/{apidocsId}/documentation", "id": "apigee.organizations.sites.apidocs.updateDocumentation" }, "delete": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1DeleteResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/sites/{sitesId}/apidocs/{apidocsId}", "id": "apigee.organizations.sites.apidocs.delete", "parameters": { "name": { "description": "Required. Name of the catalog item. Use the following structure in your request: `organizations/{org}/sites/{site}/apidocs/{apidoc}`", "pattern": "^organizations/[^/]+/sites/[^/]+/apidocs/[^/]+$", "type": "string", "location": "path", "required": true } }, "description": "Deletes a catalog item.", "httpMethod": "DELETE", "path": "v1/{+name}" } } }, "apicategories": { "methods": { "patch": { "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Required. Name of the category. Use the following structure in your request: `organizations/{org}/sites/{site}/apicategories/{apicategory}`", "pattern": "^organizations/[^/]+/sites/[^/]+/apicategories/[^/]+$" } }, "description": "Updates an API category.", "httpMethod": "PATCH", "path": "v1/{+name}", "request": { "$ref": "GoogleCloudApigeeV1ApiCategory" }, "flatPath": "v1/organizations/{organizationsId}/sites/{sitesId}/apicategories/{apicategoriesId}", "id": "apigee.organizations.sites.apicategories.patch", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1ApiCategoryResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "id": "apigee.organizations.sites.apicategories.get", "flatPath": "v1/organizations/{organizationsId}/sites/{sitesId}/apicategories/{apicategoriesId}", "response": { "$ref": "GoogleCloudApigeeV1ApiCategoryResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "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, "type": "string", "location": "path" } }, "description": "Gets an API category." }, "create": { "request": { "$ref": "GoogleCloudApigeeV1ApiCategory" }, "parameters": { "parent": { "required": true, "type": "string", "location": "path", "description": "Required. Name of the portal. Use the following structure in your request: `organizations/{org}/sites/{site}`", "pattern": "^organizations/[^/]+/sites/[^/]+$" } }, "description": "Creates a new API category.", "httpMethod": "POST", "path": "v1/{+parent}/apicategories", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ApiCategoryResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/sites/{sitesId}/apicategories", "id": "apigee.organizations.sites.apicategories.create" }, "list": { "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ListApiCategoriesResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/sites/{sitesId}/apicategories", "id": "apigee.organizations.sites.apicategories.list", "parameters": { "parent": { "description": "Required. Name of the portal. Use the following structure in your request: `organizations/{org}/sites/{site}`", "pattern": "^organizations/[^/]+/sites/[^/]+$", "location": "path", "type": "string", "required": true } }, "description": "Returns the API categories associated with a portal.", "httpMethod": "GET", "path": "v1/{+parent}/apicategories" }, "delete": { "flatPath": "v1/organizations/{organizationsId}/sites/{sitesId}/apicategories/{apicategoriesId}", "id": "apigee.organizations.sites.apicategories.delete", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1DeleteResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "type": "string", "required": true, "description": "Required. Name of the category. Use the following structure in your request: `organizations/{org}/sites/{site}/apicategories/{apicategory}`", "pattern": "^organizations/[^/]+/sites/[^/]+/apicategories/[^/]+$" } }, "description": "Deletes an API category.", "httpMethod": "DELETE", "path": "v1/{+name}" } } } } }, "appgroups": { "resources": { "balance": { "methods": { "credit": { "httpMethod": "POST", "parameters": { "name": { "description": "Required. Account balance for the AppGroup. Use the following structure in your request: `organizations/{org}/appgroups/{app_group}/balance`", "pattern": "^organizations/[^/]+/appgroups/[^/]+/balance$", "required": true, "location": "path", "type": "string" } }, "description": "Credits the account balance for the AppGroup.", "path": "v1/{+name}:credit", "request": { "$ref": "GoogleCloudApigeeV1CreditAppGroupBalanceRequest" }, "id": "apigee.organizations.appgroups.balance.credit", "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/balance:credit", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1AppGroupBalance" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "adjust": { "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/balance:adjust", "id": "apigee.organizations.appgroups.balance.adjust", "response": { "$ref": "GoogleCloudApigeeV1AppGroupBalance" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}:adjust", "parameters": { "name": { "location": "path", "type": "string", "required": true, "description": "Required. Account balance for the AppGroup. Use the following structure in your request: `organizations/{org}/appgroups/{app_group}/balance`", "pattern": "^organizations/[^/]+/appgroups/[^/]+/balance$" } }, "description": "Adjust the prepaid balance for the AppGroup. This API will be used in scenarios where the AppGroup has been under-charged or over-charged.", "httpMethod": "POST", "request": { "$ref": "GoogleCloudApigeeV1AdjustAppGroupBalanceRequest" } } } }, "apps": { "resources": { "keys": { "resources": { "apiproducts": { "methods": { "delete": { "parameters": { "name": { "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}`", "pattern": "^organizations/[^/]+/appgroups/[^/]+/apps/[^/]+/keys/[^/]+/apiproducts/[^/]+$", "required": true, "location": "path", "type": "string" } }, "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.", "httpMethod": "DELETE", "path": "v1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1AppGroupAppKey" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/apps/{appsId}/keys/{keysId}/apiproducts/{apiproductsId}", "id": "apigee.organizations.appgroups.apps.keys.apiproducts.delete" }, "updateAppGroupAppKeyApiProduct": { "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/apps/{appsId}/keys/{keysId}/apiproducts/{apiproductsId}", "id": "apigee.organizations.appgroups.apps.keys.apiproducts.updateAppGroupAppKeyApiProduct", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "type": "string", "required": true, "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}`", "pattern": "^organizations/[^/]+/appgroups/[^/]+/apps/[^/]+/keys/[^/]+/apiproducts/[^/]+$" }, "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.", "location": "query" } }, "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.", "httpMethod": "POST", "path": "v1/{+name}" } } } }, "methods": { "create": { "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1AppGroupAppKey" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/apps/{appsId}/keys", "id": "apigee.organizations.appgroups.apps.keys.create", "request": { "$ref": "GoogleCloudApigeeV1AppGroupAppKey" }, "parameters": { "parent": { "location": "path", "type": "string", "required": true, "description": "Required. Parent of the AppGroup app key. Use the following structure in your request: `organizations/{org}/appgroups/{app_group_name}/apps/{app}/keys`", "pattern": "^organizations/[^/]+/appgroups/[^/]+/apps/[^/]+$" } }, "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 UpdateAppGroupAppKey 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.", "httpMethod": "POST", "path": "v1/{+parent}/keys" }, "delete": { "response": { "$ref": "GoogleCloudApigeeV1AppGroupAppKey" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.appgroups.apps.keys.delete", "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/apps/{appsId}/keys/{keysId}", "path": "v1/{+name}", "httpMethod": "DELETE", "parameters": { "name": { "required": true, "type": "string", "location": "path", "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/[^/]+$" } }, "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." }, "get": { "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/apps/{appsId}/keys/{keysId}", "id": "apigee.organizations.appgroups.apps.keys.get", "response": { "$ref": "GoogleCloudApigeeV1AppGroupAppKey" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}", "parameters": { "name": { "location": "path", "type": "string", "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}`", "pattern": "^organizations/[^/]+/appgroups/[^/]+/apps/[^/]+/keys/[^/]+$" } }, "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" }, "updateAppGroupAppKey": { "id": "apigee.organizations.appgroups.apps.keys.updateAppGroupAppKey", "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/apps/{appsId}/keys/{keysId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1AppGroupAppKey" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "name": { "required": true, "location": "path", "type": "string", "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/[^/]+$" } }, "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 and scopes 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.", "path": "v1/{+name}", "request": { "$ref": "GoogleCloudApigeeV1UpdateAppGroupAppKeyRequest" } } } } }, "methods": { "get": { "response": { "$ref": "GoogleCloudApigeeV1AppGroupApp" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.appgroups.apps.get", "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/apps/{appsId}", "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "location": "path", "type": "string", "required": true, "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/[^/]+$" } }, "description": "Returns the details for an AppGroup app." }, "update": { "id": "apigee.organizations.appgroups.apps.update", "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/apps/{appsId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1AppGroupApp" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "PUT", "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/[^/]+$", "type": "string", "location": "path", "required": true }, "action": { "type": "string", "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.", "location": "query" } }, "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.", "path": "v1/{+name}", "request": { "$ref": "GoogleCloudApigeeV1AppGroupApp" } }, "delete": { "response": { "$ref": "GoogleCloudApigeeV1AppGroupApp" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/apps/{appsId}", "id": "apigee.organizations.appgroups.apps.delete", "path": "v1/{+name}", "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/[^/]+$", "required": true, "location": "path", "type": "string" } }, "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.", "httpMethod": "DELETE" }, "create": { "id": "apigee.organizations.appgroups.apps.create", "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/apps", "response": { "$ref": "GoogleCloudApigeeV1AppGroupApp" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "path": "v1/{+parent}/apps", "httpMethod": "POST", "parameters": { "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 } }, "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.", "request": { "$ref": "GoogleCloudApigeeV1AppGroupApp" } }, "list": { "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/apps", "id": "apigee.organizations.appgroups.apps.list", "response": { "$ref": "GoogleCloudApigeeV1ListAppGroupAppsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "path": "v1/{+parent}/apps", "parameters": { "pageSize": { "description": "Optional. Maximum number entries to return. If unspecified, at most 1000 entries will be returned.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "type": "string", "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.", "location": "query" }, "parent": { "type": "string", "location": "path", "required": true, "description": "Required. Name of the AppGroup. Use the following structure in your request: `organizations/{org}/appgroups/{app_group_name}`", "pattern": "^organizations/[^/]+/appgroups/[^/]+$" } }, "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.", "httpMethod": "GET" } } }, "subscriptions": { "methods": { "create": { "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/subscriptions", "id": "apigee.organizations.appgroups.subscriptions.create", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1AppGroupSubscription" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "type": "string", "location": "path", "required": true, "description": "Required. Name of the appgroup that is purchasing a subscription to the API product. Use the following structure in your request: `organizations/{org}/appgroups/{appgroup}`", "pattern": "^organizations/[^/]+/appgroups/[^/]+$" } }, "description": "Creates a subscription to an API product. ", "httpMethod": "POST", "path": "v1/{+parent}/subscriptions", "request": { "$ref": "GoogleCloudApigeeV1AppGroupSubscription" } }, "list": { "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ListAppGroupSubscriptionsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/subscriptions", "id": "apigee.organizations.appgroups.subscriptions.list", "parameters": { "parent": { "required": true, "type": "string", "location": "path", "description": "Required. Name of the appgroup. Use the following structure in your request: `organizations/{org}/appgroups/{appgroup}`", "pattern": "^organizations/[^/]+/appgroups/[^/]+$" }, "pageSize": { "format": "int32", "description": "Optional. The maximum number of subscriptions to return. The service may return fewer than this value. If unspecified, at most 100 subscriptions will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", "location": "query", "type": "integer" }, "pageToken": { "description": "Optional. A page token, received from a previous `ListAppGroupSubscriptions` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListAppGroupSubscriptions` must match the call that provided the page token.", "location": "query", "type": "string" } }, "description": "List all api product subscriptions for an appgroup.", "httpMethod": "GET", "path": "v1/{+parent}/subscriptions" }, "expire": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1AppGroupSubscription" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/subscriptions/{subscriptionsId}:expire", "id": "apigee.organizations.appgroups.subscriptions.expire", "request": { "$ref": "GoogleCloudApigeeV1ExpireAppGroupSubscriptionRequest" }, "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. Name of the API product subscription. Use the following structure in your request: `organizations/{org}/appgroups/{appgroup}/subscriptions/{subscription}`", "pattern": "^organizations/[^/]+/appgroups/[^/]+/subscriptions/[^/]+$" } }, "description": "Expires an API product subscription immediately.", "httpMethod": "POST", "path": "v1/{+name}:expire" }, "get": { "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/subscriptions/{subscriptionsId}", "id": "apigee.organizations.appgroups.subscriptions.get", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1AppGroupSubscription" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "Required. The name of the AppGroupSubscription to retrieve. Format: `organizations/{org}/appgroups/{appgroup}/subscriptions/{subscription}`", "pattern": "^organizations/[^/]+/appgroups/[^/]+/subscriptions/[^/]+$", "required": true, "location": "path", "type": "string" } }, "description": "Get an api product subscription for an appgroup.", "httpMethod": "GET", "path": "v1/{+name}" } } } }, "methods": { "create": { "path": "v1/{+parent}/appgroups", "httpMethod": "POST", "parameters": { "parent": { "description": "Required. Name of the Apigee organization in which the AppGroup is created. Use the following structure in your request: `organizations/{org}`.", "pattern": "^organizations/[^/]+$", "required": true, "type": "string", "location": "path" } }, "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`.", "request": { "$ref": "GoogleCloudApigeeV1AppGroup" }, "id": "apigee.organizations.appgroups.create", "flatPath": "v1/organizations/{organizationsId}/appgroups", "response": { "$ref": "GoogleCloudApigeeV1AppGroup" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ] }, "list": { "id": "apigee.organizations.appgroups.list", "flatPath": "v1/organizations/{organizationsId}/appgroups", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ListAppGroupsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "pageSize": { "format": "int32", "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.", "location": "query", "type": "integer" }, "pageToken": { "description": "The starting index record for listing the AppGroups.", "location": "query", "type": "string" }, "filter": { "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=", "location": "query", "type": "string" }, "parent": { "location": "path", "type": "string", "required": true, "description": "Required. Name of the Apigee organization. Use the following structure in your request: `organizations/{org}`.", "pattern": "^organizations/[^/]+$" } }, "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.", "path": "v1/{+parent}/appgroups" }, "updateMonetizationConfig": { "request": { "$ref": "GoogleCloudApigeeV1AppGroupMonetizationConfig" }, "path": "v1/{+name}", "httpMethod": "PUT", "parameters": { "name": { "description": "Required. Monetization configuration for the AppGroup. Use the following structure in your request: `organizations/{org}/appgroups/{app_group}/monetizationConfig`", "pattern": "^organizations/[^/]+/appgroups/[^/]+/monetizationConfig$", "type": "string", "location": "path", "required": true } }, "description": "Updates the monetization configuration for the AppGroup.", "response": { "$ref": "GoogleCloudApigeeV1AppGroupMonetizationConfig" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.appgroups.updateMonetizationConfig", "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/monetizationConfig" }, "delete": { "httpMethod": "DELETE", "parameters": { "name": { "required": true, "location": "path", "type": "string", "description": "Required. Name of the AppGroup. Use the following structure in your request: `organizations/{org}/appgroups/{app_group_name}`", "pattern": "^organizations/[^/]+/appgroups/[^/]+$" } }, "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 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.", "path": "v1/{+name}", "id": "apigee.organizations.appgroups.delete", "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1AppGroup" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "getBalance": { "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "description": "Required. Account balance for the AppGroup. Use the following structure in your request: `organizations/{org}/appgroups/{app_group}/balance`", "pattern": "^organizations/[^/]+/appgroups/[^/]+/balance$", "type": "string", "location": "path", "required": true } }, "description": "Gets the account balance for the AppGroup.", "response": { "$ref": "GoogleCloudApigeeV1AppGroupBalance" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.appgroups.getBalance", "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/balance" }, "get": { "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}", "id": "apigee.organizations.appgroups.get", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1AppGroup" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. Name of the AppGroup. Use the following structure in your request: `organizations/{org}/appgroups/{app_group_name}`", "pattern": "^organizations/[^/]+/appgroups/[^/]+$" } }, "description": "Returns the AppGroup details for the provided AppGroup name in the request URI.", "httpMethod": "GET", "path": "v1/{+name}" }, "update": { "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}", "id": "apigee.organizations.appgroups.update", "response": { "$ref": "GoogleCloudApigeeV1AppGroup" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}", "parameters": { "name": { "location": "path", "type": "string", "required": true, "description": "Required. Name of the AppGroup. Use the following structure in your request: `organizations/{org}/appgroups/{app_group_name}`", "pattern": "^organizations/[^/]+/appgroups/[^/]+$" }, "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" } }, "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.", "httpMethod": "PUT", "request": { "$ref": "GoogleCloudApigeeV1AppGroup" } }, "getMonetizationConfig": { "path": "v1/{+name}", "parameters": { "name": { "description": "Required. Monetization configuration for the AppGroup. Use the following structure in your request: `organizations/{org}/appgroups/{app_group}/monetizationConfig`", "pattern": "^organizations/[^/]+/appgroups/[^/]+/monetizationConfig$", "required": true, "type": "string", "location": "path" } }, "description": "Gets the monetization configuration for the AppGroup.", "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/appgroups/{appgroupsId}/monetizationConfig", "id": "apigee.organizations.appgroups.getMonetizationConfig", "response": { "$ref": "GoogleCloudApigeeV1AppGroupMonetizationConfig" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] } } }, "envgroups": { "resources": { "attachments": { "methods": { "create": { "id": "apigee.organizations.envgroups.attachments.create", "flatPath": "v1/organizations/{organizationsId}/envgroups/{envgroupsId}/attachments", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "parent": { "description": "Required. EnvironmentGroup under which to create the attachment in the following format: `organizations/{org}/envgroups/{envgroup}`.", "pattern": "^organizations/[^/]+/envgroups/[^/]+$", "required": true, "location": "path", "type": "string" } }, "description": "Creates a new attachment of an environment to an environment group.", "path": "v1/{+parent}/attachments", "request": { "$ref": "GoogleCloudApigeeV1EnvironmentGroupAttachment" } }, "list": { "path": "v1/{+parent}/attachments", "parameters": { "parent": { "required": true, "type": "string", "location": "path", "description": "Required. Name of the environment group in the following format: `organizations/{org}/envgroups/{envgroup}`.", "pattern": "^organizations/[^/]+/envgroups/[^/]+$" }, "pageSize": { "description": "Maximum number of environment group attachments to return. The page size defaults to 25.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "Page token, returned by a previous ListEnvironmentGroupAttachments call, that you can use to retrieve the next page.", "location": "query", "type": "string" } }, "description": "Lists all attachments of an environment group.", "httpMethod": "GET", "response": { "$ref": "GoogleCloudApigeeV1ListEnvironmentGroupAttachmentsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "flatPath": "v1/organizations/{organizationsId}/envgroups/{envgroupsId}/attachments", "id": "apigee.organizations.envgroups.attachments.list" }, "delete": { "path": "v1/{+name}", "parameters": { "name": { "description": "Required. Name of the environment group attachment to delete in the following format: `organizations/{org}/envgroups/{envgroup}/attachments/{attachment}`.", "pattern": "^organizations/[^/]+/envgroups/[^/]+/attachments/[^/]+$", "required": true, "location": "path", "type": "string" } }, "description": "Deletes an environment group attachment.", "httpMethod": "DELETE", "flatPath": "v1/organizations/{organizationsId}/envgroups/{envgroupsId}/attachments/{attachmentsId}", "id": "apigee.organizations.envgroups.attachments.delete", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "get": { "parameters": { "name": { "description": "Required. Name of the environment group attachment in the following format: `organizations/{org}/envgroups/{envgroup}/attachments/{attachment}`", "pattern": "^organizations/[^/]+/envgroups/[^/]+/attachments/[^/]+$", "required": true, "type": "string", "location": "path" } }, "description": "Gets an environment group attachment.", "httpMethod": "GET", "path": "v1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1EnvironmentGroupAttachment" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/envgroups/{envgroupsId}/attachments/{attachmentsId}", "id": "apigee.organizations.envgroups.attachments.get" } } } }, "methods": { "delete": { "id": "apigee.organizations.envgroups.delete", "flatPath": "v1/organizations/{organizationsId}/envgroups/{envgroupsId}", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "DELETE", "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 } }, "description": "Deletes an environment group." }, "create": { "path": "v1/{+parent}/envgroups", "httpMethod": "POST", "parameters": { "parent": { "location": "path", "type": "string", "required": true, "description": "Required. Name of the organization in which to create the environment group in the following format: `organizations/{org}`.", "pattern": "^organizations/[^/]+$" }, "name": { "description": "Optional. ID of the environment group. Overrides any ID in the environment_group resource.", "location": "query", "type": "string" } }, "description": "Creates a new environment group.", "request": { "$ref": "GoogleCloudApigeeV1EnvironmentGroup" }, "id": "apigee.organizations.envgroups.create", "flatPath": "v1/organizations/{organizationsId}/envgroups", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ] }, "list": { "response": { "$ref": "GoogleCloudApigeeV1ListEnvironmentGroupsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "flatPath": "v1/organizations/{organizationsId}/envgroups", "id": "apigee.organizations.envgroups.list", "path": "v1/{+parent}/envgroups", "parameters": { "pageSize": { "description": "Maximum number of environment groups to return. The page size defaults to 25.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "type": "string", "description": "Page token, returned from a previous ListEnvironmentGroups call, that you can use to retrieve the next page.", "location": "query" }, "parent": { "location": "path", "type": "string", "required": true, "description": "Required. Name of the organization for which to list environment groups in the following format: `organizations/{org}`.", "pattern": "^organizations/[^/]+$" } }, "description": "Lists all environment groups.", "httpMethod": "GET" }, "getDeployedIngressConfig": { "flatPath": "v1/organizations/{organizationsId}/envgroups/{envgroupsId}/deployedIngressConfig", "id": "apigee.organizations.envgroups.getDeployedIngressConfig", "response": { "$ref": "GoogleCloudApigeeV1EnvironmentGroupConfig" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}", "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Required. Name of the deployed configuration for the environment group in the following format: 'organizations/{org}/envgroups/{envgroup}/deployedIngressConfig'.", "pattern": "^organizations/[^/]+/envgroups/[^/]+/deployedIngressConfig$" }, "view": { "location": "query", "enum": [ "INGRESS_CONFIG_VIEW_UNSPECIFIED", "BASIC", "FULL" ], "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." ], "description": "When set to FULL, additional details about the specific deployments receiving traffic will be included in the IngressConfig response's RoutingRules." } }, "description": "Gets the deployed ingress configuration for an environment group.", "httpMethod": "GET" }, "get": { "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "required": true, "location": "path", "type": "string", "description": "Required. Name of the environment group in the following format: `organizations/{org}/envgroups/{envgroup}`.", "pattern": "^organizations/[^/]+/envgroups/[^/]+$" } }, "description": "Gets an environment group.", "id": "apigee.organizations.envgroups.get", "flatPath": "v1/organizations/{organizationsId}/envgroups/{envgroupsId}", "response": { "$ref": "GoogleCloudApigeeV1EnvironmentGroup" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "patch": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/envgroups/{envgroupsId}", "id": "apigee.organizations.envgroups.patch", "request": { "$ref": "GoogleCloudApigeeV1EnvironmentGroup" }, "parameters": { "name": { "description": "Required. Name of the environment group to update in the format: `organizations/{org}/envgroups/{envgroup}.", "pattern": "^organizations/[^/]+/envgroups/[^/]+$", "required": true, "location": "path", "type": "string" }, "updateMask": { "type": "string", "description": "Optional. List of fields to be updated.", "location": "query", "format": "google-fieldmask" } }, "description": "Updates an environment group.", "httpMethod": "PATCH", "path": "v1/{+name}" } } }, "apiproducts": { "methods": { "move": { "response": { "$ref": "GoogleCloudApigeeV1ApiProduct" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.apiproducts.move", "flatPath": "v1/organizations/{organizationsId}/apiproducts/{apiproductsId}:move", "request": { "$ref": "GoogleCloudApigeeV1MoveApiProductRequest" }, "path": "v1/{+name}:move", "httpMethod": "POST", "parameters": { "name": { "description": "Required. API product to move in the following format: `organizations/{org}/apiproducts/{apiproduct}", "pattern": "^organizations/[^/]+/apiproducts/[^/]+$", "required": true, "type": "string", "location": "path" } }, "description": "Moves an API product to a different space." }, "attributes": { "flatPath": "v1/organizations/{organizationsId}/apiproducts/{apiproductsId}/attributes", "id": "apigee.organizations.apiproducts.attributes", "response": { "$ref": "GoogleCloudApigeeV1Attributes" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}/attributes", "parameters": { "name": { "required": true, "location": "path", "type": "string", "description": "Required. Name of the API product. Use the following structure in your request: `organizations/{org}/apiproducts/{apiproduct}` If the API Product resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apiproducts/[^/]+$" } }, "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.", "httpMethod": "POST", "request": { "$ref": "GoogleCloudApigeeV1Attributes" } }, "get": { "path": "v1/{+name}", "parameters": { "name": { "description": "Required. Name of the API product. Use the following structure in your request: `organizations/{org}/apiproducts/{apiproduct}` If the resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apiproducts/[^/]+$", "required": true, "type": "string", "location": "path" } }, "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.", "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/apiproducts/{apiproductsId}", "id": "apigee.organizations.apiproducts.get", "response": { "$ref": "GoogleCloudApigeeV1ApiProduct" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "update": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1ApiProduct" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/apiproducts/{apiproductsId}", "id": "apigee.organizations.apiproducts.update", "request": { "$ref": "GoogleCloudApigeeV1ApiProduct" }, "parameters": { "name": { "description": "Required. Name of the API product. Use the following structure in your request: `organizations/{org}/apiproducts/{apiproduct}` If the resource has the `space` attribute set, IAM permissions are checked against the Space resource path.To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apiproducts/[^/]+$", "required": true, "type": "string", "location": "path" } }, "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.", "httpMethod": "PUT", "path": "v1/{+name}" }, "create": { "request": { "$ref": "GoogleCloudApigeeV1ApiProduct" }, "path": "v1/{+parent}/apiproducts", "httpMethod": "POST", "parameters": { "parent": { "required": true, "location": "path", "type": "string", "description": "Required. Name of the organization in which the API product will be created. Use the following structure in your request: `organizations/{org}` If the resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+$" } }, "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?", "response": { "$ref": "GoogleCloudApigeeV1ApiProduct" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "id": "apigee.organizations.apiproducts.create", "flatPath": "v1/organizations/{organizationsId}/apiproducts" }, "list": { "flatPath": "v1/organizations/{organizationsId}/apiproducts", "id": "apigee.organizations.apiproducts.list", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ListApiProductsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "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" }, "expand": { "type": "boolean", "description": "Flag that specifies whether to expand the results. Set to `true` to get expanded details about each API.", "location": "query" }, "count": { "format": "int64", "type": "string", "description": "Enter the number of API products you want returned in the API call. The limit is 1000.", "location": "query" }, "parent": { "description": "Required. Name of the organization. Use the following structure in your request: `organizations/{org}` If the resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+$", "required": true, "location": "path", "type": "string" }, "space": { "type": "string", "description": "Optional. The Space to list API products for. When none provided, all the spaces the user has list access, will be used implicitly, and the same following rules will apply. Can be used in conjunction with start_key, expand and count for paginated response. Composite queries with attributename and attributevalue are not supported yet.", "location": "query" }, "attributevalue": { "description": "Value of the attribute used to filter the search.", "location": "query", "type": "string" }, "attributename": { "description": "Name of the attribute used to filter the search.", "location": "query", "type": "string" } }, "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. If the resource has the `space` attribute set, the response may not return all resources. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "httpMethod": "GET", "path": "v1/{+parent}/apiproducts" }, "delete": { "id": "apigee.organizations.apiproducts.delete", "flatPath": "v1/organizations/{organizationsId}/apiproducts/{apiproductsId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1ApiProduct" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "parameters": { "name": { "required": true, "location": "path", "type": "string", "description": "Required. Name of the API product. Use the following structure in your request: `organizations/{org}/apiproducts/{apiproduct}` If the resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apiproducts/[^/]+$" } }, "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.", "path": "v1/{+name}" } }, "resources": { "attributes": { "methods": { "updateApiProductAttribute": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1Attribute" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/apiproducts/{apiproductsId}/attributes/{attributesId}", "id": "apigee.organizations.apiproducts.attributes.updateApiProductAttribute", "request": { "$ref": "GoogleCloudApigeeV1Attribute" }, "parameters": { "name": { "description": "Required. Name of the API product. Use the following structure in your request: `organizations/{org}/apiproducts/{apiproduct}` If the API Product resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apiproducts/[^/]+/attributes/[^/]+$", "required": true, "type": "string", "location": "path" } }, "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.", "httpMethod": "POST", "path": "v1/{+name}" }, "list": { "parameters": { "parent": { "description": "Required. Name of the API product. Use the following structure in your request: `organizations/{org}/apiproducts/{apiproduct}` If the API Product resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apiproducts/[^/]+$", "location": "path", "type": "string", "required": true } }, "description": "Lists all API product attributes.", "httpMethod": "GET", "path": "v1/{+parent}/attributes", "flatPath": "v1/organizations/{organizationsId}/apiproducts/{apiproductsId}/attributes", "id": "apigee.organizations.apiproducts.attributes.list", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1Attributes" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "parameters": { "name": { "description": "Required. Name of the API product attribute. Use the following structure in your request: `organizations/{org}/apiproducts/{apiproduct}/attributes/{attribute}` If the API Product resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apiproducts/[^/]+/attributes/[^/]+$", "required": true, "location": "path", "type": "string" } }, "description": "Deletes an API product attribute.", "httpMethod": "DELETE", "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/apiproducts/{apiproductsId}/attributes/{attributesId}", "id": "apigee.organizations.apiproducts.attributes.delete", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1Attribute" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "path": "v1/{+name}", "parameters": { "name": { "description": "Required. Name of the API product attribute. Use the following structure in your request: `organizations/{org}/apiproducts/{apiproduct}/attributes/{attribute}` If the API Product resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apiproducts/[^/]+/attributes/[^/]+$", "required": true, "type": "string", "location": "path" } }, "description": "Gets the value of an API product attribute.", "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/apiproducts/{apiproductsId}/attributes/{attributesId}", "id": "apigee.organizations.apiproducts.attributes.get", "response": { "$ref": "GoogleCloudApigeeV1Attribute" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] } } }, "rateplans": { "methods": { "create": { "id": "apigee.organizations.apiproducts.rateplans.create", "flatPath": "v1/organizations/{organizationsId}/apiproducts/{apiproductsId}/rateplans", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1RatePlan" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "parent": { "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}` If the API Product resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apiproducts/[^/]+$", "required": true, "location": "path", "type": "string" } }, "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.", "path": "v1/{+parent}/rateplans", "request": { "$ref": "GoogleCloudApigeeV1RatePlan" } }, "list": { "parameters": { "state": { "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": "State of the rate plans (`DRAFT`, `PUBLISHED`) that you want to display.", "location": "query", "enum": [ "STATE_UNSPECIFIED", "DRAFT", "PUBLISHED" ], "type": "string" }, "orderBy": { "type": "string", "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.", "location": "query" }, "parent": { "location": "path", "type": "string", "required": true, "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. If the API Product resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apiproducts/[^/]+$" }, "count": { "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.", "location": "query", "type": "integer", "format": "int32" }, "expand": { "description": "Flag that specifies whether to expand the results. Set to `true` to get expanded details about each API. Defaults to `false`.", "location": "query", "type": "boolean" }, "startKey": { "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.", "location": "query", "type": "string" } }, "description": "Lists all the rate plans for an API product.", "httpMethod": "GET", "path": "v1/{+parent}/rateplans", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ListRatePlansResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/apiproducts/{apiproductsId}/rateplans", "id": "apigee.organizations.apiproducts.rateplans.list" }, "delete": { "path": "v1/{+name}", "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "type": "string", "required": true, "description": "Required. ID of the rate plan. Use the following structure in your request: `organizations/{org}/apiproducts/{apiproduct}/rateplans/{rateplan}` If the API Product resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apiproducts/[^/]+/rateplans/[^/]+$" } }, "description": "Deletes a rate plan.", "id": "apigee.organizations.apiproducts.rateplans.delete", "flatPath": "v1/organizations/{organizationsId}/apiproducts/{apiproductsId}/rateplans/{rateplansId}", "response": { "$ref": "GoogleCloudApigeeV1RatePlan" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "get": { "flatPath": "v1/organizations/{organizationsId}/apiproducts/{apiproductsId}/rateplans/{rateplansId}", "id": "apigee.organizations.apiproducts.rateplans.get", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1RatePlan" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "Required. Name of the rate plan. Use the following structure in your request: `organizations/{org}/apiproducts/{apiproduct}/rateplans/{rateplan}` If the API Product resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apiproducts/[^/]+/rateplans/[^/]+$", "location": "path", "type": "string", "required": true } }, "description": "Gets the details of a rate plan.", "httpMethod": "GET", "path": "v1/{+name}" }, "update": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1RatePlan" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.apiproducts.rateplans.update", "flatPath": "v1/organizations/{organizationsId}/apiproducts/{apiproductsId}/rateplans/{rateplansId}", "request": { "$ref": "GoogleCloudApigeeV1RatePlan" }, "httpMethod": "PUT", "parameters": { "name": { "description": "Required. Name of the rate plan. Use the following structure in your request: `organizations/{org}/apiproducts/{apiproduct}/rateplans/{rateplan}` If the API Product resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apiproducts/[^/]+/rateplans/[^/]+$", "required": true, "location": "path", "type": "string" } }, "description": "Updates an existing rate plan.", "path": "v1/{+name}" } } } } }, "endpointAttachments": { "methods": { "get": { "path": "v1/{+name}", "parameters": { "name": { "description": "Required. Name of the endpoint attachment. Use the following structure in your request: `organizations/{org}/endpointAttachments/{endpoint_attachment}`", "pattern": "^organizations/[^/]+/endpointAttachments/[^/]+$", "required": true, "location": "path", "type": "string" } }, "description": "Gets the endpoint attachment.", "httpMethod": "GET", "response": { "$ref": "GoogleCloudApigeeV1EndpointAttachment" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/endpointAttachments/{endpointAttachmentsId}", "id": "apigee.organizations.endpointAttachments.get" }, "delete": { "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. Name of the endpoint attachment. Use the following structure in your request: `organizations/{org}/endpointAttachments/{endpoint_attachment}`", "pattern": "^organizations/[^/]+/endpointAttachments/[^/]+$" } }, "description": "Deletes an endpoint attachment.", "httpMethod": "DELETE", "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/endpointAttachments/{endpointAttachmentsId}", "id": "apigee.organizations.endpointAttachments.delete", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "create": { "id": "apigee.organizations.endpointAttachments.create", "flatPath": "v1/organizations/{organizationsId}/endpointAttachments", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "path": "v1/{+parent}/endpointAttachments", "httpMethod": "POST", "parameters": { "parent": { "description": "Required. Organization the endpoint attachment will be created in.", "pattern": "^organizations/[^/]+$", "required": true, "type": "string", "location": "path" }, "endpointAttachmentId": { "type": "string", "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.", "location": "query" } }, "description": "Creates an endpoint attachment. **Note:** Not supported for Apigee hybrid.", "request": { "$ref": "GoogleCloudApigeeV1EndpointAttachment" } }, "list": { "path": "v1/{+parent}/endpointAttachments", "parameters": { "pageSize": { "format": "int32", "description": "Optional. Maximum number of endpoint attachments to return. If unspecified, at most 25 attachments will be returned.", "location": "query", "type": "integer" }, "pageToken": { "description": "Optional. Page token, returned from a previous `ListEndpointAttachments` call, that you can use to retrieve the next page.", "location": "query", "type": "string" }, "parent": { "description": "Required. Name of the organization for which to list endpoint attachments. Use the following structure in your request: `organizations/{org}`", "pattern": "^organizations/[^/]+$", "location": "path", "type": "string", "required": true } }, "description": "Lists the endpoint attachments in an organization.", "httpMethod": "GET", "response": { "$ref": "GoogleCloudApigeeV1ListEndpointAttachmentsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "flatPath": "v1/organizations/{organizationsId}/endpointAttachments", "id": "apigee.organizations.endpointAttachments.list" } } }, "reports": { "methods": { "delete": { "path": "v1/{+name}", "httpMethod": "DELETE", "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Required. Custom Report name of the form: `organizations/{organization_id}/reports/{report_name}`", "pattern": "^organizations/[^/]+/reports/[^/]+$" } }, "description": "Deletes an existing custom report definition", "response": { "$ref": "GoogleCloudApigeeV1DeleteCustomReportResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.reports.delete", "flatPath": "v1/organizations/{organizationsId}/reports/{reportsId}" }, "create": { "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1CustomReport" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.reports.create", "flatPath": "v1/organizations/{organizationsId}/reports", "request": { "$ref": "GoogleCloudApigeeV1CustomReport" }, "httpMethod": "POST", "parameters": { "parent": { "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/[^/]+$", "required": true, "location": "path", "type": "string" } }, "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.", "path": "v1/{+parent}/reports" }, "list": { "response": { "$ref": "GoogleCloudApigeeV1ListCustomReportsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "flatPath": "v1/organizations/{organizationsId}/reports", "id": "apigee.organizations.reports.list", "path": "v1/{+parent}/reports", "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": { "type": "boolean", "description": "Set to 'true' to get expanded details about each custom report.", "location": "query" } }, "description": "Return a list of Custom Reports", "httpMethod": "GET" }, "get": { "flatPath": "v1/organizations/{organizationsId}/reports/{reportsId}", "id": "apigee.organizations.reports.get", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1CustomReport" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "Required. Custom Report name of the form: `organizations/{organization_id}/reports/{report_name}`", "pattern": "^organizations/[^/]+/reports/[^/]+$", "required": true, "location": "path", "type": "string" } }, "description": "Retrieve a custom report definition.", "httpMethod": "GET", "path": "v1/{+name}" }, "update": { "flatPath": "v1/organizations/{organizationsId}/reports/{reportsId}", "id": "apigee.organizations.reports.update", "response": { "$ref": "GoogleCloudApigeeV1CustomReport" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}", "parameters": { "name": { "description": "Required. Custom Report name of the form: `organizations/{organization_id}/reports/{report_name}`", "pattern": "^organizations/[^/]+/reports/[^/]+$", "location": "path", "type": "string", "required": true } }, "description": "Update an existing custom report definition", "httpMethod": "PUT", "request": { "$ref": "GoogleCloudApigeeV1CustomReport" } } } }, "securityProfilesV2": { "methods": { "get": { "path": "v1/{+name}", "parameters": { "name": { "description": "Required. The name of the security profile v2 to get. Format: `organizations/{org}/securityProfilesV2/{profile}`", "pattern": "^organizations/[^/]+/securityProfilesV2/[^/]+$", "required": true, "type": "string", "location": "path" }, "riskAssessmentType": { "location": "query", "enum": [ "RISK_ASSESSMENT_TYPE_UNSPECIFIED", "APIGEE", "API_HUB" ], "type": "string", "description": "Optional. The risk assessment type of the security profile. Defaults to ADVANCED_API_SECURITY.", "enumDescriptions": [ "Risk assessment type is not specified.", "Risk assessment type is Apigee.", "Risk assessment type is API Hub." ] } }, "description": "Get a security profile v2.", "httpMethod": "GET", "response": { "$ref": "GoogleCloudApigeeV1SecurityProfileV2" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/securityProfilesV2/{securityProfilesV2Id}", "id": "apigee.organizations.securityProfilesV2.get" }, "patch": { "request": { "$ref": "GoogleCloudApigeeV1SecurityProfileV2" }, "parameters": { "name": { "description": "Identifier. Name of the security profile v2 resource. Format: organizations/{org}/securityProfilesV2/{profile}", "pattern": "^organizations/[^/]+/securityProfilesV2/[^/]+$", "required": true, "type": "string", "location": "path" }, "updateMask": { "description": "Optional. The list of fields to update. Valid fields to update are `description` and `profileAssessmentConfigs`.", "location": "query", "type": "string", "format": "google-fieldmask" } }, "description": "Update a security profile V2.", "httpMethod": "PATCH", "path": "v1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1SecurityProfileV2" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/securityProfilesV2/{securityProfilesV2Id}", "id": "apigee.organizations.securityProfilesV2.patch" }, "delete": { "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/securityProfilesV2/{securityProfilesV2Id}", "id": "apigee.organizations.securityProfilesV2.delete", "path": "v1/{+name}", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. The name of the security profile v2 to delete. Format: `organizations/{org}/securityProfilesV2/{profile}`", "pattern": "^organizations/[^/]+/securityProfilesV2/[^/]+$" }, "riskAssessmentType": { "enumDescriptions": [ "Risk assessment type is not specified.", "Risk assessment type is Apigee.", "Risk assessment type is API Hub." ], "description": "Optional. The risk assessment type of the security profile. Defaults to ADVANCED_API_SECURITY.", "type": "string", "location": "query", "enum": [ "RISK_ASSESSMENT_TYPE_UNSPECIFIED", "APIGEE", "API_HUB" ] } }, "description": "Delete a security profile v2.", "httpMethod": "DELETE" }, "create": { "flatPath": "v1/organizations/{organizationsId}/securityProfilesV2", "id": "apigee.organizations.securityProfilesV2.create", "response": { "$ref": "GoogleCloudApigeeV1SecurityProfileV2" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "path": "v1/{+parent}/securityProfilesV2", "parameters": { "parent": { "description": "Required. The parent resource name. Format: `organizations/{org}`", "pattern": "^organizations/[^/]+$", "required": true, "type": "string", "location": "path" }, "securityProfileV2Id": { "description": "Required. The security profile id.", "location": "query", "type": "string" } }, "description": "Create a security profile v2.", "httpMethod": "POST", "request": { "$ref": "GoogleCloudApigeeV1SecurityProfileV2" } }, "list": { "flatPath": "v1/organizations/{organizationsId}/securityProfilesV2", "id": "apigee.organizations.securityProfilesV2.list", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ListSecurityProfilesV2Response" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "location": "path", "type": "string", "required": true, "description": "Required. For a specific organization, list of all the security profiles. Format: `organizations/{org}`", "pattern": "^organizations/[^/]+$" }, "riskAssessmentType": { "location": "query", "enum": [ "RISK_ASSESSMENT_TYPE_UNSPECIFIED", "APIGEE", "API_HUB" ], "type": "string", "enumDescriptions": [ "Risk assessment type is not specified.", "Risk assessment type is Apigee.", "Risk assessment type is API Hub." ], "description": "Optional. The risk assessment type of the security profiles. Defaults to ADVANCED_API_SECURITY." }, "pageSize": { "description": "Optional. The maximum number of profiles to return", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "type": "string", "description": "Optional. A page token, received from a previous `ListSecurityProfilesV2` call. Provide this to retrieve the subsequent page.", "location": "query" } }, "description": "List security profiles v2.", "httpMethod": "GET", "path": "v1/{+parent}/securityProfilesV2" } } }, "apis": { "resources": { "deployments": { "methods": { "list": { "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ListDeploymentsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/deployments", "id": "apigee.organizations.apis.deployments.list", "parameters": { "parent": { "type": "string", "location": "path", "required": true, "description": "Required. Name of the API proxy for which to return deployment information in the following format: `organizations/{org}/apis/{api}` If the API proxy resource has the `space` attribute set, IAM permissions are checked differently . To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apis/[^/]+$" } }, "description": "Lists all deployments of an API proxy.", "httpMethod": "GET", "path": "v1/{+parent}/deployments" } } }, "revisions": { "methods": { "updateApiProxyRevision": { "response": { "$ref": "GoogleCloudApigeeV1ApiProxyRevision" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/revisions/{revisionsId}", "id": "apigee.organizations.apis.revisions.updateApiProxyRevision", "request": { "$ref": "GoogleApiHttpBody" }, "path": "v1/{+name}", "parameters": { "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" }, "name": { "location": "path", "type": "string", "required": true, "description": "Required. API proxy revision to update in the following format: `organizations/{org}/apis/{api}/revisions/{rev}` If the API Proxy resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apis/[^/]+/revisions/[^/]+$" } }, "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`.", "httpMethod": "POST" }, "get": { "path": "v1/{+name}", "parameters": { "name": { "required": true, "location": "path", "type": "string", "description": "Required. API proxy revision in the following format: `organizations/{org}/apis/{api}/revisions/{rev}` If the API Proxy resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apis/[^/]+/revisions/[^/]+$" }, "format": { "type": "string", "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" } }, "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).", "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/revisions/{revisionsId}", "id": "apigee.organizations.apis.revisions.get", "response": { "$ref": "GoogleApiHttpBody" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "delete": { "parameters": { "name": { "description": "Required. API proxy revision in the following format: `organizations/{org}/apis/{api}/revisions/{rev}` If the API Proxy resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apis/[^/]+/revisions/[^/]+$", "required": true, "location": "path", "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.", "httpMethod": "DELETE", "path": "v1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1ApiProxyRevision" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/revisions/{revisionsId}", "id": "apigee.organizations.apis.revisions.delete" } }, "resources": { "deployments": { "methods": { "list": { "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/revisions/{revisionsId}/deployments", "id": "apigee.organizations.apis.revisions.deployments.list", "response": { "$ref": "GoogleCloudApigeeV1ListDeploymentsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "path": "v1/{+parent}/deployments", "parameters": { "parent": { "required": true, "type": "string", "location": "path", "description": "Required. Name of the API proxy revision for which to return deployment information in the following format: `organizations/{org}/apis/{api}/revisions/{rev}`. If the API proxy resource has the `space` attribute set, IAM permissions are checked differently . To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apis/[^/]+/revisions/[^/]+$" } }, "description": "Lists all deployments of an API proxy revision.", "httpMethod": "GET" } } } } }, "keyvaluemaps": { "methods": { "create": { "path": "v1/{+parent}/keyvaluemaps", "parameters": { "parent": { "required": true, "location": "path", "type": "string", "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}` If the API Proxy resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apis/[^/]+$" } }, "description": "Creates a key value map in an API proxy.", "httpMethod": "POST", "request": { "$ref": "GoogleCloudApigeeV1KeyValueMap" }, "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/keyvaluemaps", "id": "apigee.organizations.apis.keyvaluemaps.create", "response": { "$ref": "GoogleCloudApigeeV1KeyValueMap" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ] }, "get": { "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "location": "path", "type": "string", "required": true, "description": "Required. Scope as indicated by the URI in which to fetch the key value map. 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}`. If the KeyValueMap is under an API Proxy resource that has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apis/[^/]+/keyvaluemaps/[^/]+$" } }, "description": "Get the key value map scoped to an organization, environment, or API proxy.", "response": { "$ref": "GoogleCloudApigeeV1KeyValueMap" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.apis.keyvaluemaps.get", "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/keyvaluemaps/{keyvaluemapsId}" }, "update": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1KeyValueMap" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.apis.keyvaluemaps.update", "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/keyvaluemaps/{keyvaluemapsId}", "request": { "$ref": "GoogleCloudApigeeV1KeyValueMap" }, "httpMethod": "PUT", "parameters": { "name": { "description": "Required. Scope as indicated by the URI in which to fetch the key value map. 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}`. If the KeyValueMap is under an API Proxy resource that has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apis/[^/]+/keyvaluemaps/[^/]+$", "location": "path", "type": "string", "required": true } }, "description": "Update the key value map scoped to an organization, environment, or API proxy.", "path": "v1/{+name}" }, "delete": { "id": "apigee.organizations.apis.keyvaluemaps.delete", "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/keyvaluemaps/{keyvaluemapsId}", "response": { "$ref": "GoogleCloudApigeeV1KeyValueMap" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "DELETE", "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Required. Name of the key value map. Use the following structure in your request: `organizations/{org}/apis/{api}/keyvaluemaps/{keyvaluemap}` If the API Proxy resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apis/[^/]+/keyvaluemaps/[^/]+$" } }, "description": "Deletes a key value map from an API proxy." } }, "resources": { "entries": { "methods": { "create": { "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/keyvaluemaps/{keyvaluemapsId}/entries", "id": "apigee.organizations.apis.keyvaluemaps.entries.create", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "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}`. If the KeyValueMap is under an API Proxy resource that has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apis/[^/]+/keyvaluemaps/[^/]+$", "location": "path", "type": "string", "required": true } }, "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.", "httpMethod": "POST", "path": "v1/{+parent}/entries", "request": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" } }, "list": { "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ListKeyValueEntriesResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/keyvaluemaps/{keyvaluemapsId}/entries", "id": "apigee.organizations.apis.keyvaluemaps.entries.list", "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}`. If the KeyValueMap is under an API Proxy resource that has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apis/[^/]+/keyvaluemaps/[^/]+$", "required": true, "location": "path", "type": "string" }, "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" }, "pageToken": { "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.", "location": "query", "type": "string" } }, "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", "path": "v1/{+parent}/entries" }, "delete": { "path": "v1/{+name}", "parameters": { "name": { "required": true, "location": "path", "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}`. If the KeyValueMap is under an API Proxy resource that has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apis/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$" } }, "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.", "httpMethod": "DELETE", "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}", "id": "apigee.organizations.apis.keyvaluemaps.entries.delete", "response": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "get": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.apis.keyvaluemaps.entries.get", "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}", "httpMethod": "GET", "parameters": { "name": { "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}`. If the KeyValueMap is under an API Proxy resource that has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apis/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$", "type": "string", "location": "path", "required": true } }, "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.", "path": "v1/{+name}" }, "update": { "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}", "id": "apigee.organizations.apis.keyvaluemaps.entries.update", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "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}`. If the KeyValueMap is under an API Proxy resource that has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apis/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$", "location": "path", "type": "string", "required": true } }, "description": "Update key value entry scoped to an organization, environment, or API proxy for an existing key.", "httpMethod": "PUT", "path": "v1/{+name}", "request": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" } } } } } }, "debugsessions": { "methods": { "list": { "path": "v1/{+parent}/debugsessions", "parameters": { "pageSize": { "format": "int32", "type": "integer", "description": "Optional. Maximum number of debug sessions to return. The page size defaults to 25.", "location": "query" }, "pageToken": { "description": "Optional. Page token, returned from a previous ListApiDebugSessions call, that you can use to retrieve the next page.", "location": "query", "type": "string" }, "parent": { "description": "Required. The name of the API Proxy for which to list debug sessions. Must be of the form: `organizations/{organization}/apis/{api}`.", "pattern": "^organizations/[^/]+/apis/[^/]+$", "type": "string", "location": "path", "required": true } }, "description": "Lists debug sessions that are currently active in the given API Proxy.", "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}/debugsessions", "id": "apigee.organizations.apis.debugsessions.list", "response": { "$ref": "GoogleCloudApigeeV1ListApiDebugSessionsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ] } } } }, "methods": { "patch": { "parameters": { "name": { "description": "Required. API proxy to update in the following format: `organizations/{org}/apis/{api}` If the resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apis/[^/]+$", "location": "path", "type": "string", "required": true }, "updateMask": { "format": "google-fieldmask", "type": "string", "description": "Required. The list of fields to update.", "location": "query" } }, "description": "Updates an existing API proxy.", "httpMethod": "PATCH", "path": "v1/{+name}", "request": { "$ref": "GoogleCloudApigeeV1ApiProxy" }, "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}", "id": "apigee.organizations.apis.patch", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1ApiProxy" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "move": { "httpMethod": "POST", "parameters": { "name": { "required": true, "location": "path", "type": "string", "description": "Required. API proxy to move in the following format: `organizations/{org}/apis/{api}`", "pattern": "^organizations/[^/]+/apis/[^/]+$" } }, "description": "Moves an API proxy to a different space.", "path": "v1/{+name}:move", "request": { "$ref": "GoogleCloudApigeeV1MoveApiProxyRequest" }, "id": "apigee.organizations.apis.move", "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}:move", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1ApiProxy" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "httpMethod": "GET", "parameters": { "name": { "description": "Required. Name of the API proxy in the following format: `organizations/{org}/apis/{api}` If the API Proxy resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apis/[^/]+$", "location": "path", "type": "string", "required": true } }, "description": "Gets an API proxy including a list of existing revisions.", "path": "v1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1ApiProxy" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.apis.get", "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}" }, "list": { "path": "v1/{+parent}/apis", "parameters": { "includeRevisions": { "description": "Flag that specifies whether to include a list of revisions in the response.", "location": "query", "type": "boolean" }, "parent": { "description": "Required. Name of the organization in the following format: `organizations/{org}` If the resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+$", "type": "string", "location": "path", "required": true }, "includeMetaData": { "type": "boolean", "description": "Flag that specifies whether to include API proxy metadata in the response.", "location": "query" }, "space": { "description": "Optional. The space ID to filter the list of proxies (optional). If unspecified, all proxies in the organization will be listed.", "location": "query", "type": "string" } }, "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. If the resource has the `space` attribute set, the response may not return all resources. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "httpMethod": "GET", "response": { "$ref": "GoogleCloudApigeeV1ListApiProxiesResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "flatPath": "v1/organizations/{organizationsId}/apis", "id": "apigee.organizations.apis.list" }, "create": { "response": { "$ref": "GoogleCloudApigeeV1ApiProxyRevision" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "id": "apigee.organizations.apis.create", "flatPath": "v1/organizations/{organizationsId}/apis", "request": { "$ref": "GoogleApiHttpBody" }, "path": "v1/{+parent}/apis", "httpMethod": "POST", "parameters": { "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" }, "parent": { "type": "string", "location": "path", "required": true, "description": "Required. Name of the organization in the following format: `organizations/{org}` If the API Proxy resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+$" }, "space": { "type": "string", "description": "Optional. The ID of the space associated with this proxy. Any IAM policies applied to the space will affect access to this proxy. Note that this field is only respected when creating a new proxy. It has no effect when creating a new revision for an existing proxy.", "location": "query" }, "name": { "description": "Name of the API proxy. Restrict the characters used to: A-Za-z0-9._-", "location": "query", "type": "string" }, "action": { "type": "string", "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.", "location": "query" } }, "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." }, "delete": { "response": { "$ref": "GoogleCloudApigeeV1ApiProxy" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/apis/{apisId}", "id": "apigee.organizations.apis.delete", "path": "v1/{+name}", "parameters": { "name": { "description": "Required. Name of the API proxy in the following format: `organizations/{org}/apis/{api}` If the API Proxy resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/apis/[^/]+$", "type": "string", "location": "path", "required": true } }, "description": "Deletes an API proxy and all associated endpoints, policies, resources, and revisions. The API proxy must be undeployed before you can delete it.", "httpMethod": "DELETE" } } }, "datacollectors": { "methods": { "delete": { "path": "v1/{+name}", "httpMethod": "DELETE", "parameters": { "name": { "description": "Required. Name of the data collector in the following format: `organizations/{org}/datacollectors/{data_collector_id}`.", "pattern": "^organizations/[^/]+/datacollectors/[^/]+$", "location": "path", "type": "string", "required": true } }, "description": "Deletes a data collector.", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.datacollectors.delete", "flatPath": "v1/organizations/{organizationsId}/datacollectors/{datacollectorsId}" }, "create": { "parameters": { "parent": { "description": "Required. Name of the organization in which to create the data collector in the following format: `organizations/{org}`.", "pattern": "^organizations/[^/]+$", "location": "path", "type": "string", "required": true }, "dataCollectorId": { "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.", "location": "query" } }, "description": "Creates a new data collector.", "httpMethod": "POST", "path": "v1/{+parent}/datacollectors", "request": { "$ref": "GoogleCloudApigeeV1DataCollector" }, "flatPath": "v1/organizations/{organizationsId}/datacollectors", "id": "apigee.organizations.datacollectors.create", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1DataCollector" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "response": { "$ref": "GoogleCloudApigeeV1ListDataCollectorsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "id": "apigee.organizations.datacollectors.list", "flatPath": "v1/organizations/{organizationsId}/datacollectors", "path": "v1/{+parent}/datacollectors", "httpMethod": "GET", "parameters": { "parent": { "required": true, "location": "path", "type": "string", "description": "Required. Name of the organization for which to list data collectors in the following format: `organizations/{org}`.", "pattern": "^organizations/[^/]+$" }, "pageSize": { "format": "int32", "type": "integer", "description": "Maximum number of data collectors to return. The page size defaults to 25.", "location": "query" }, "pageToken": { "description": "Page token, returned from a previous ListDataCollectors call, that you can use to retrieve the next page.", "location": "query", "type": "string" } }, "description": "Lists all data collectors." }, "get": { "id": "apigee.organizations.datacollectors.get", "flatPath": "v1/organizations/{organizationsId}/datacollectors/{datacollectorsId}", "response": { "$ref": "GoogleCloudApigeeV1DataCollector" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Required. Name of the data collector in the following format: `organizations/{org}/datacollectors/{data_collector_id}`.", "pattern": "^organizations/[^/]+/datacollectors/[^/]+$" } }, "description": "Gets a data collector." }, "patch": { "request": { "$ref": "GoogleCloudApigeeV1DataCollector" }, "path": "v1/{+name}", "parameters": { "name": { "description": "Required. Name of the data collector in the following format: `organizations/{org}/datacollectors/{data_collector_id}`.", "pattern": "^organizations/[^/]+/datacollectors/[^/]+$", "type": "string", "location": "path", "required": true }, "updateMask": { "format": "google-fieldmask", "type": "string", "description": "List of fields to be updated.", "location": "query" } }, "description": "Updates a data collector.", "httpMethod": "PATCH", "response": { "$ref": "GoogleCloudApigeeV1DataCollector" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/datacollectors/{datacollectorsId}", "id": "apigee.organizations.datacollectors.patch" } } }, "instances": { "methods": { "delete": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}", "id": "apigee.organizations.instances.delete", "parameters": { "name": { "description": "Required. Name of the instance. Use the following structure in your request: `organizations/{org}/instances/{instance}`.", "pattern": "^organizations/[^/]+/instances/[^/]+$", "location": "path", "type": "string", "required": true } }, "description": "Deletes an Apigee runtime instance. The instance stops serving requests and the runtime data is deleted. **Note:** Not supported for Apigee hybrid.", "httpMethod": "DELETE", "path": "v1/{+name}" }, "create": { "request": { "$ref": "GoogleCloudApigeeV1Instance" }, "httpMethod": "POST", "parameters": { "parent": { "location": "path", "type": "string", "required": true, "description": "Required. Name of the organization. Use the following structure in your request: `organizations/{org}`.", "pattern": "^organizations/[^/]+$" } }, "description": "Creates an Apigee runtime instance. The instance is accessible from the authorized network configured on the organization. **Note:** Not supported for Apigee hybrid.", "path": "v1/{+parent}/instances", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.instances.create", "flatPath": "v1/organizations/{organizationsId}/instances" }, "list": { "id": "apigee.organizations.instances.list", "flatPath": "v1/organizations/{organizationsId}/instances", "response": { "$ref": "GoogleCloudApigeeV1ListInstancesResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "path": "v1/{+parent}/instances", "httpMethod": "GET", "parameters": { "pageSize": { "format": "int32", "description": "Maximum number of instances to return. Defaults to 25.", "location": "query", "type": "integer" }, "pageToken": { "type": "string", "description": "Page token, returned from a previous ListInstances call, that you can use to retrieve the next page of content.", "location": "query" }, "parent": { "type": "string", "location": "path", "required": true, "description": "Required. Name of the organization. Use the following structure in your request: `organizations/{org}`.", "pattern": "^organizations/[^/]+$" } }, "description": "Lists all Apigee runtime instances for the organization. **Note:** Not supported for Apigee hybrid." }, "get": { "path": "v1/{+name}", "parameters": { "name": { "required": true, "location": "path", "type": "string", "description": "Required. Name of the instance. Use the following structure in your request: `organizations/{org}/instances/{instance}`.", "pattern": "^organizations/[^/]+/instances/[^/]+$" } }, "description": "Gets the details for an Apigee runtime instance. **Note:** Not supported for Apigee hybrid.", "httpMethod": "GET", "response": { "$ref": "GoogleCloudApigeeV1Instance" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}", "id": "apigee.organizations.instances.get" }, "patch": { "httpMethod": "PATCH", "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Required. Name of the instance. Use the following structure in your request: `organizations/{org}/instances/{instance}`.", "pattern": "^organizations/[^/]+/instances/[^/]+$" }, "updateMask": { "format": "google-fieldmask", "description": "List of fields to be updated.", "location": "query", "type": "string" } }, "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" }, "id": "apigee.organizations.instances.patch", "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "reportStatus": { "path": "v1/{+instance}:reportStatus", "httpMethod": "POST", "parameters": { "instance": { "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/[^/]+$", "type": "string", "location": "path", "required": true } }, "description": "Reports the latest status for a runtime instance.", "request": { "$ref": "GoogleCloudApigeeV1ReportInstanceStatusRequest" }, "id": "apigee.organizations.instances.reportStatus", "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}:reportStatus", "response": { "$ref": "GoogleCloudApigeeV1ReportInstanceStatusResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "instance" ] } }, "resources": { "canaryevaluations": { "methods": { "create": { "id": "apigee.organizations.instances.canaryevaluations.create", "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}/canaryevaluations", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "parent": { "description": "Required. Name of the organization. Use the following structure in your request: `organizations/{org}/instances/{instance}`.", "pattern": "^organizations/[^/]+/instances/[^/]+$", "required": true, "type": "string", "location": "path" } }, "description": "Creates a new canary evaluation for an organization.", "path": "v1/{+parent}/canaryevaluations", "request": { "$ref": "GoogleCloudApigeeV1CanaryEvaluation" } }, "get": { "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. Name of the CanaryEvaluation. Use the following structure in your request: `organizations/{org}/instances/*/canaryevaluations/{evaluation}`", "pattern": "^organizations/[^/]+/instances/[^/]+/canaryevaluations/[^/]+$" } }, "description": "Gets a CanaryEvaluation for an organization.", "response": { "$ref": "GoogleCloudApigeeV1CanaryEvaluation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.instances.canaryevaluations.get", "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}/canaryevaluations/{canaryevaluationsId}" } } }, "natAddresses": { "methods": { "delete": { "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}/natAddresses/{natAddressesId}", "id": "apigee.organizations.instances.natAddresses.delete", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "Required. Name of the nat address. Use the following structure in your request: `organizations/{org}/instances/{instances}/natAddresses/{nataddress}``", "pattern": "^organizations/[^/]+/instances/[^/]+/natAddresses/[^/]+$", "required": true, "location": "path", "type": "string" } }, "description": "Deletes the NAT address. Connections that are actively using the address are drained before it is removed. **Note:** Not supported for Apigee hybrid.", "httpMethod": "DELETE", "path": "v1/{+name}" }, "list": { "path": "v1/{+parent}/natAddresses", "httpMethod": "GET", "parameters": { "pageSize": { "format": "int32", "description": "Maximum number of natAddresses to return. Defaults to 25.", "location": "query", "type": "integer" }, "pageToken": { "type": "string", "description": "Page token, returned from a previous ListNatAddresses call, that you can use to retrieve the next page of content.", "location": "query" }, "parent": { "location": "path", "type": "string", "required": true, "description": "Required. Name of the instance. Use the following structure in your request: `organizations/{org}/instances/{instance}`", "pattern": "^organizations/[^/]+/instances/[^/]+$" } }, "description": "Lists the NAT addresses for an Apigee instance. **Note:** Not supported for Apigee hybrid.", "response": { "$ref": "GoogleCloudApigeeV1ListNatAddressesResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "id": "apigee.organizations.instances.natAddresses.list", "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}/natAddresses" }, "create": { "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}/natAddresses", "id": "apigee.organizations.instances.natAddresses.create", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "path": "v1/{+parent}/natAddresses", "parameters": { "parent": { "required": true, "location": "path", "type": "string", "description": "Required. Name of the instance. Use the following structure in your request: `organizations/{org}/instances/{instance}`", "pattern": "^organizations/[^/]+/instances/[^/]+$" } }, "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.", "httpMethod": "POST", "request": { "$ref": "GoogleCloudApigeeV1NatAddress" } }, "get": { "response": { "$ref": "GoogleCloudApigeeV1NatAddress" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}/natAddresses/{natAddressesId}", "id": "apigee.organizations.instances.natAddresses.get", "path": "v1/{+name}", "parameters": { "name": { "location": "path", "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/[^/]+$" } }, "description": "Gets the details of a NAT address. **Note:** Not supported for Apigee hybrid.", "httpMethod": "GET" }, "activate": { "id": "apigee.organizations.instances.natAddresses.activate", "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}/natAddresses/{natAddressesId}:activate", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}:activate", "httpMethod": "POST", "parameters": { "name": { "type": "string", "location": "path", "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/[^/]+$" } }, "description": "Activates the NAT address. The Apigee instance can now use this for Internet egress traffic. **Note:** Not supported for Apigee hybrid.", "request": { "$ref": "GoogleCloudApigeeV1ActivateNatAddressRequest" } } } }, "attachments": { "methods": { "get": { "id": "apigee.organizations.instances.attachments.get", "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}/attachments/{attachmentsId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1InstanceAttachment" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "name": { "location": "path", "type": "string", "required": true, "description": "Required. Name of the attachment. Use the following structure in your request: `organizations/{org}/instances/{instance}/attachments/{attachment}`", "pattern": "^organizations/[^/]+/instances/[^/]+/attachments/[^/]+$" } }, "description": "Gets an attachment. **Note:** Not supported for Apigee hybrid.", "path": "v1/{+name}" }, "delete": { "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}/attachments/{attachmentsId}", "id": "apigee.organizations.instances.attachments.delete", "path": "v1/{+name}", "parameters": { "name": { "required": true, "location": "path", "type": "string", "description": "Required. Name of the attachment. Use the following structure in your request: `organizations/{org}/instances/{instance}/attachments/{attachment}`.", "pattern": "^organizations/[^/]+/instances/[^/]+/attachments/[^/]+$" } }, "description": "Deletes an attachment. **Note:** Not supported for Apigee hybrid.", "httpMethod": "DELETE" }, "create": { "request": { "$ref": "GoogleCloudApigeeV1InstanceAttachment" }, "httpMethod": "POST", "parameters": { "parent": { "location": "path", "type": "string", "required": true, "description": "Required. Name of the instance. Use the following structure in your request: `organizations/{org}/instances/{instance}`.", "pattern": "^organizations/[^/]+/instances/[^/]+$" } }, "description": "Creates a new attachment of an environment to an instance. **Note:** Not supported for Apigee hybrid.", "path": "v1/{+parent}/attachments", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.instances.attachments.create", "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}/attachments" }, "list": { "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ListInstanceAttachmentsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/instances/{instancesId}/attachments", "id": "apigee.organizations.instances.attachments.list", "parameters": { "pageSize": { "format": "int32", "description": "Maximum number of instance attachments to return. Defaults to 25.", "location": "query", "type": "integer" }, "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" }, "parent": { "description": "Required. Name of the organization. Use the following structure in your request: `organizations/{org}/instances/{instance}`", "pattern": "^organizations/[^/]+/instances/[^/]+$", "type": "string", "location": "path", "required": true } }, "description": "Lists all attachments to an instance. **Note:** Not supported for Apigee hybrid.", "httpMethod": "GET", "path": "v1/{+parent}/attachments" } } } } }, "developers": { "resources": { "balance": { "methods": { "adjust": { "request": { "$ref": "GoogleCloudApigeeV1AdjustDeveloperBalanceRequest" }, "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, "type": "string", "location": "path" } }, "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.", "httpMethod": "POST", "path": "v1/{+name}:adjust", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1DeveloperBalance" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/balance:adjust", "id": "apigee.organizations.developers.balance.adjust" }, "credit": { "path": "v1/{+name}:credit", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. Account balance for the developer. Use the following structure in your request: `organizations/{org}/developers/{developer}/balance`", "pattern": "^organizations/[^/]+/developers/[^/]+/balance$" } }, "description": "Credits the account balance for the developer.", "httpMethod": "POST", "request": { "$ref": "GoogleCloudApigeeV1CreditDeveloperBalanceRequest" }, "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/balance:credit", "id": "apigee.organizations.developers.balance.credit", "response": { "$ref": "GoogleCloudApigeeV1DeveloperBalance" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] } } }, "apps": { "methods": { "get": { "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}", "id": "apigee.organizations.developers.apps.get", "response": { "$ref": "GoogleCloudApigeeV1DeveloperApp" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}", "parameters": { "name": { "description": "Required. Name of the developer app. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/apps/{app}`", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+$", "type": "string", "location": "path", "required": true }, "entity": { "type": "string", "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.", "location": "query" }, "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.", "location": "query", "type": "string" } }, "description": "Returns the details for a developer app.", "httpMethod": "GET" }, "update": { "path": "v1/{+name}", "httpMethod": "PUT", "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Required. Name of the developer app. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/apps/{app}`", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+$" } }, "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.", "request": { "$ref": "GoogleCloudApigeeV1DeveloperApp" }, "id": "apigee.organizations.developers.apps.update", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}", "response": { "$ref": "GoogleCloudApigeeV1DeveloperApp" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "attributes": { "response": { "$ref": "GoogleCloudApigeeV1Attributes" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}/attributes", "id": "apigee.organizations.developers.apps.attributes", "request": { "$ref": "GoogleCloudApigeeV1Attributes" }, "path": "v1/{+name}/attributes", "parameters": { "name": { "description": "Required. Name of the developer app. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/apps/{app}`", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+$", "location": "path", "type": "string", "required": true } }, "description": "Updates attributes for a developer app. This API replaces the current attributes with those specified in the request.", "httpMethod": "POST" }, "generateKeyPairOrUpdateDeveloperAppStatus": { "id": "apigee.organizations.developers.apps.generateKeyPairOrUpdateDeveloperAppStatus", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1DeveloperApp" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Required. Name of the developer app. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/apps/{app}`", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+$" }, "action": { "type": "string", "description": "Action. Valid values are `approve` or `revoke`.", "location": "query" } }, "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.", "path": "v1/{+name}", "request": { "$ref": "GoogleCloudApigeeV1DeveloperApp" } }, "delete": { "response": { "$ref": "GoogleCloudApigeeV1DeveloperApp" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.developers.apps.delete", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}", "path": "v1/{+name}", "httpMethod": "DELETE", "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Required. Name of the developer app. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/apps/{app}`", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+$" } }, "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." }, "create": { "request": { "$ref": "GoogleCloudApigeeV1DeveloperApp" }, "path": "v1/{+parent}/apps", "httpMethod": "POST", "parameters": { "parent": { "required": true, "type": "string", "location": "path", "description": "Required. Name of the developer. Use the following structure in your request: `organizations/{org}/developers/{developer_email}`", "pattern": "^organizations/[^/]+/developers/[^/]+$" } }, "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.", "response": { "$ref": "GoogleCloudApigeeV1DeveloperApp" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "id": "apigee.organizations.developers.apps.create", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps" }, "list": { "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ListDeveloperAppsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps", "id": "apigee.organizations.developers.apps.list", "parameters": { "parent": { "description": "Required. Name of the developer. Use the following structure in your request: `organizations/{org}/developers/{developer_email}`", "pattern": "^organizations/[^/]+/developers/[^/]+$", "required": true, "location": "path", "type": "string" }, "startKey": { "type": "string", "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.", "location": "query" }, "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. **Note**: If set to `true`, the `apigee.developerapps.get` permission is required.", "location": "query" }, "count": { "format": "int64", "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.", "location": "query", "type": "string" }, "shallowExpand": { "description": "Optional. Specifies whether to expand the results in shallow mode. Set to `true` to expand the results in shallow mode. **Note**: If set to `true`, the `apigee.developerapps.get` permission is required.", "location": "query", "type": "boolean" } }, "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.", "httpMethod": "GET", "path": "v1/{+parent}/apps" } }, "resources": { "attributes": { "methods": { "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}`", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+/attributes/[^/]+$", "location": "path", "type": "string", "required": true } }, "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.", "httpMethod": "POST", "path": "v1/{+name}", "request": { "$ref": "GoogleCloudApigeeV1Attribute" }, "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}/attributes/{attributesId}", "id": "apigee.organizations.developers.apps.attributes.updateDeveloperAppAttribute", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1Attribute" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "path": "v1/{+parent}/attributes", "httpMethod": "GET", "parameters": { "parent": { "required": true, "type": "string", "location": "path", "description": "Required. Name of the developer app. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/apps/{app}`", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+$" } }, "description": "Returns a list of all developer app attributes.", "id": "apigee.organizations.developers.apps.attributes.list", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}/attributes", "response": { "$ref": "GoogleCloudApigeeV1Attributes" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ] }, "get": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1Attribute" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.developers.apps.attributes.get", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}/attributes/{attributesId}", "httpMethod": "GET", "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}`", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+/attributes/[^/]+$", "required": true, "location": "path", "type": "string" } }, "description": "Returns a developer app attribute.", "path": "v1/{+name}" }, "delete": { "path": "v1/{+name}", "httpMethod": "DELETE", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. Name of the developer app attribute. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/apps/{app}/attributes/{attribute}`", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+/attributes/[^/]+$" } }, "description": "Deletes a developer app attribute.", "id": "apigee.organizations.developers.apps.attributes.delete", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}/attributes/{attributesId}", "response": { "$ref": "GoogleCloudApigeeV1Attribute" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] } } }, "keys": { "resources": { "create": { "methods": { "create": { "id": "apigee.organizations.developers.apps.keys.create.create", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}/keys/create", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1DeveloperAppKey" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "parent": { "required": true, "location": "path", "type": "string", "description": "Parent of the developer app key. Use the following structure in your request: 'organizations/{org}/developers/{developerEmail}/apps/{appName}'", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+$" } }, "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.", "path": "v1/{+parent}/keys/create", "request": { "$ref": "GoogleCloudApigeeV1DeveloperAppKey" } } } }, "apiproducts": { "methods": { "delete": { "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}/keys/{keysId}/apiproducts/{apiproductsId}", "id": "apigee.organizations.developers.apps.keys.apiproducts.delete", "response": { "$ref": "GoogleCloudApigeeV1DeveloperAppKey" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}", "parameters": { "name": { "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}`", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+/keys/[^/]+/apiproducts/[^/]+$", "required": true, "type": "string", "location": "path" } }, "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.", "httpMethod": "DELETE" }, "updateDeveloperAppKeyApiProduct": { "parameters": { "name": { "required": true, "location": "path", "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}`", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+/keys/[^/]+/apiproducts/[^/]+$" }, "action": { "type": "string", "description": "Approve or revoke the consumer key by setting this value to `approve` or `revoke`, respectively.", "location": "query" } }, "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.", "httpMethod": "POST", "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}/keys/{keysId}/apiproducts/{apiproductsId}", "id": "apigee.organizations.developers.apps.keys.apiproducts.updateDeveloperAppKeyApiProduct", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } } }, "methods": { "replaceDeveloperAppKey": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1DeveloperAppKey" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.developers.apps.keys.replaceDeveloperAppKey", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}/keys/{keysId}", "request": { "$ref": "GoogleCloudApigeeV1DeveloperAppKey" }, "httpMethod": "PUT", "parameters": { "name": { "required": true, "location": "path", "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}`", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+/keys/[^/]+$" } }, "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.", "path": "v1/{+name}" }, "updateDeveloperAppKey": { "parameters": { "name": { "required": true, "location": "path", "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}`", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+/keys/[^/]+$" }, "action": { "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`.", "location": "query", "type": "string" } }, "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 and scopes associated with the API product to the developer app key. The status of the key can be updated via \"action\" Query Parameter. None of the other fields can be updated via this 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. None of the other fields can be updated. You can use the same key to access all API products associated with the app.", "httpMethod": "POST", "path": "v1/{+name}", "request": { "$ref": "GoogleCloudApigeeV1DeveloperAppKey" }, "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}/keys/{keysId}", "id": "apigee.organizations.developers.apps.keys.updateDeveloperAppKey", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1DeveloperAppKey" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1DeveloperAppKey" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.developers.apps.keys.get", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}/keys/{keysId}", "httpMethod": "GET", "parameters": { "name": { "location": "path", "type": "string", "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}`", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+/keys/[^/]+$" } }, "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}" }, "create": { "id": "apigee.organizations.developers.apps.keys.create", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}/keys", "response": { "$ref": "GoogleCloudApigeeV1DeveloperAppKey" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "path": "v1/{+parent}/keys", "httpMethod": "POST", "parameters": { "parent": { "description": "Parent of the developer app key. Use the following structure in your request: 'organizations/{org}/developers/{developerEmail}/apps/{appName}'", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+$", "type": "string", "location": "path", "required": true } }, "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.", "request": { "$ref": "GoogleCloudApigeeV1DeveloperAppKey" } }, "delete": { "response": { "$ref": "GoogleCloudApigeeV1DeveloperAppKey" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/apps/{appsId}/keys/{keysId}", "id": "apigee.organizations.developers.apps.keys.delete", "path": "v1/{+name}", "parameters": { "name": { "required": true, "location": "path", "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}`", "pattern": "^organizations/[^/]+/developers/[^/]+/apps/[^/]+/keys/[^/]+$" } }, "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.", "httpMethod": "DELETE" } } } } }, "subscriptions": { "methods": { "create": { "path": "v1/{+parent}/subscriptions", "httpMethod": "POST", "parameters": { "parent": { "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}`", "pattern": "^organizations/[^/]+/developers/[^/]+$", "required": true, "location": "path", "type": "string" } }, "description": "Creates a subscription to an API product. ", "request": { "$ref": "GoogleCloudApigeeV1DeveloperSubscription" }, "id": "apigee.organizations.developers.subscriptions.create", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/subscriptions", "response": { "$ref": "GoogleCloudApigeeV1DeveloperSubscription" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ] }, "list": { "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/subscriptions", "id": "apigee.organizations.developers.subscriptions.list", "response": { "$ref": "GoogleCloudApigeeV1ListDeveloperSubscriptionsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "path": "v1/{+parent}/subscriptions", "parameters": { "parent": { "location": "path", "type": "string", "required": true, "description": "Required. Email address of the developer. Use the following structure in your request: `organizations/{org}/developers/{developer_email}`", "pattern": "^organizations/[^/]+/developers/[^/]+$" }, "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" }, "count": { "type": "integer", "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" } }, "description": "Lists all API product subscriptions for a developer.", "httpMethod": "GET" }, "expire": { "id": "apigee.organizations.developers.subscriptions.expire", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/subscriptions/{subscriptionsId}:expire", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1DeveloperSubscription" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "name": { "location": "path", "type": "string", "required": true, "description": "Required. Name of the API product subscription. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/subscriptions/{subscription}`", "pattern": "^organizations/[^/]+/developers/[^/]+/subscriptions/[^/]+$" } }, "description": "Expires an API product subscription immediately.", "path": "v1/{+name}:expire", "request": { "$ref": "GoogleCloudApigeeV1ExpireDeveloperSubscriptionRequest" } }, "get": { "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "description": "Required. Name of the API product subscription. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/subscriptions/{subscription}`", "pattern": "^organizations/[^/]+/developers/[^/]+/subscriptions/[^/]+$", "required": true, "type": "string", "location": "path" } }, "description": "Gets details for an API product subscription.", "response": { "$ref": "GoogleCloudApigeeV1DeveloperSubscription" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.developers.subscriptions.get", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/subscriptions/{subscriptionsId}" } } }, "attributes": { "methods": { "delete": { "path": "v1/{+name}", "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, "location": "path", "type": "string" } }, "description": "Deletes a developer attribute.", "httpMethod": "DELETE", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/attributes/{attributesId}", "id": "apigee.organizations.developers.attributes.delete", "response": { "$ref": "GoogleCloudApigeeV1Attribute" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "get": { "response": { "$ref": "GoogleCloudApigeeV1Attribute" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.developers.attributes.get", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/attributes/{attributesId}", "path": "v1/{+name}", "httpMethod": "GET", "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, "location": "path", "type": "string" } }, "description": "Returns the value of the specified developer attribute." }, "updateDeveloperAttribute": { "parameters": { "name": { "required": true, "location": "path", "type": "string", "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/[^/]+$" } }, "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.", "httpMethod": "POST", "path": "v1/{+name}", "request": { "$ref": "GoogleCloudApigeeV1Attribute" }, "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/attributes/{attributesId}", "id": "apigee.organizations.developers.attributes.updateDeveloperAttribute", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1Attribute" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "path": "v1/{+parent}/attributes", "parameters": { "parent": { "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}`", "pattern": "^organizations/[^/]+/developers/[^/]+$", "type": "string", "location": "path", "required": true } }, "description": "Returns a list of all developer attributes.", "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/attributes", "id": "apigee.organizations.developers.attributes.list", "response": { "$ref": "GoogleCloudApigeeV1Attributes" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ] } } } }, "methods": { "getMonetizationConfig": { "parameters": { "name": { "description": "Required. Monetization configuration for the developer. Use the following structure in your request: `organizations/{org}/developers/{developer}/monetizationConfig`", "pattern": "^organizations/[^/]+/developers/[^/]+/monetizationConfig$", "required": true, "type": "string", "location": "path" } }, "description": "Gets the monetization configuration for the developer.", "httpMethod": "GET", "path": "v1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1DeveloperMonetizationConfig" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/monetizationConfig", "id": "apigee.organizations.developers.getMonetizationConfig" }, "get": { "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "location": "path", "type": "string", "required": true, "description": "Required. Email address of the developer. Use the following structure in your request: `organizations/{org}/developers/{developer_email}`", "pattern": "^organizations/[^/]+/developers/[^/]+$" }, "action": { "description": "Status of the developer. Valid values are `active` or `inactive`.", "location": "query", "type": "string" } }, "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.", "id": "apigee.organizations.developers.get", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}", "response": { "$ref": "GoogleCloudApigeeV1Developer" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "updateMonetizationConfig": { "response": { "$ref": "GoogleCloudApigeeV1DeveloperMonetizationConfig" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/monetizationConfig", "id": "apigee.organizations.developers.updateMonetizationConfig", "request": { "$ref": "GoogleCloudApigeeV1DeveloperMonetizationConfig" }, "path": "v1/{+name}", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. Monetization configuration for the developer. Use the following structure in your request: `organizations/{org}/developers/{developer}/monetizationConfig`", "pattern": "^organizations/[^/]+/developers/[^/]+/monetizationConfig$" } }, "description": "Updates the monetization configuration for the developer.", "httpMethod": "PUT" }, "create": { "response": { "$ref": "GoogleCloudApigeeV1Developer" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "id": "apigee.organizations.developers.create", "flatPath": "v1/organizations/{organizationsId}/developers", "request": { "$ref": "GoogleCloudApigeeV1Developer" }, "path": "v1/{+parent}/developers", "httpMethod": "POST", "parameters": { "parent": { "required": true, "location": "path", "type": "string", "description": "Required. Name of the Apigee organization in which the developer is created. Use the following structure in your request: `organizations/{org}`.", "pattern": "^organizations/[^/]+$" } }, "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." }, "list": { "flatPath": "v1/organizations/{organizationsId}/developers", "id": "apigee.organizations.developers.list", "response": { "$ref": "GoogleCloudApigeeV1ListOfDevelopersResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "path": "v1/{+parent}/developers", "parameters": { "parent": { "required": true, "type": "string", "location": "path", "description": "Required. Name of the Apigee organization. Use the following structure in your request: `organizations/{org}`.", "pattern": "^organizations/[^/]+$" }, "includeCompany": { "type": "boolean", "description": "Flag that specifies whether to include company details in the response.", "location": "query" }, "app": { "type": "string", "description": "Optional. List only Developers that are associated with the app. Note that start_key, count are not applicable for this filter criteria.", "location": "query" }, "startKey": { "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 ```", "location": "query", "type": "string" }, "ids": { "type": "string", "description": "Optional. List of IDs to include, separated by commas.", "location": "query" }, "expand": { "type": "boolean", "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.", "location": "query" }, "count": { "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.", "location": "query", "type": "string", "format": "int64" } }, "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.", "httpMethod": "GET" }, "attributes": { "id": "apigee.organizations.developers.attributes", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/attributes", "response": { "$ref": "GoogleCloudApigeeV1Attributes" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "path": "v1/{+parent}/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}`", "pattern": "^organizations/[^/]+/developers/[^/]+$", "location": "path", "type": "string", "required": true } }, "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.", "request": { "$ref": "GoogleCloudApigeeV1Attributes" } }, "update": { "id": "apigee.organizations.developers.update", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1Developer" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "PUT", "parameters": { "name": { "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", "location": "path" } }, "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}", "request": { "$ref": "GoogleCloudApigeeV1Developer" } }, "setDeveloperStatus": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}", "id": "apigee.organizations.developers.setDeveloperStatus", "parameters": { "name": { "description": "Required. Name of the developer. Use the following structure in your request: `organizations/{org}/developers/{developer_id}`", "pattern": "^organizations/[^/]+/developers/[^/]+$", "location": "path", "type": "string", "required": true }, "action": { "description": "Status of the developer. Valid values are `active` and `inactive`.", "location": "query", "type": "string" } }, "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`", "httpMethod": "POST", "path": "v1/{+name}" }, "getBalance": { "path": "v1/{+name}", "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Required. Account balance for the developer. Use the following structure in your request: `organizations/{org}/developers/{developer}/balance`", "pattern": "^organizations/[^/]+/developers/[^/]+/balance$" } }, "description": "Gets the account balance for the developer.", "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}/balance", "id": "apigee.organizations.developers.getBalance", "response": { "$ref": "GoogleCloudApigeeV1DeveloperBalance" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "delete": { "path": "v1/{+name}", "parameters": { "name": { "description": "Required. Email address of the developer. Use the following structure in your request: `organizations/{org}/developers/{developer_email}`", "pattern": "^organizations/[^/]+/developers/[^/]+$", "type": "string", "location": "path", "required": true } }, "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 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.", "httpMethod": "DELETE", "response": { "$ref": "GoogleCloudApigeeV1Developer" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/developers/{developersId}", "id": "apigee.organizations.developers.delete" } } }, "apps": { "methods": { "get": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1App" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/apps/{appsId}", "id": "apigee.organizations.apps.get", "parameters": { "name": { "description": "Required. App ID in the following format: `organizations/{org}/apps/{app}`", "pattern": "^organizations/[^/]+/apps/[^/]+$", "required": true, "location": "path", "type": "string" } }, "description": "Gets the app profile for the specified app ID.", "httpMethod": "GET", "path": "v1/{+name}" }, "list": { "httpMethod": "GET", "parameters": { "parent": { "type": "string", "location": "path", "required": true, "description": "Required. Resource path of the parent in the following format: `organizations/{org}`", "pattern": "^organizations/[^/]+$" }, "pageToken": { "type": "string", "description": "Optional. The starting index record for listing the developers. \"page_token\" is supported from ver 1.10.0 and above.", "location": "query" }, "startKey": { "description": "Returns the list of apps starting from the specified app ID.", "location": "query", "type": "string" }, "pageSize": { "format": "int32", "type": "integer", "description": "Optional. Count of apps a single page can have in the response. If unspecified, at most 1000 apps will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000. \"page_size\" is supported from ver 1.10.0 and above.", "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" }, "rows": { "format": "int64", "description": "Optional. Maximum number of app IDs to return. Defaults to 1000, which is also the upper limit. To get more than 1000, use pagination with 'pageSize' and 'pageToken' parameters.", "location": "query", "type": "string" }, "status": { "type": "string", "description": "Optional. Filter by the status of the app. Valid values are `approved` or `revoked`. Defaults to `approved`.", "location": "query" }, "ids": { "type": "string", "description": "Optional. Comma-separated list of app IDs on which to filter.", "location": "query" }, "includeCred": { "type": "boolean", "description": "Optional. Flag that specifies whether to include credentials in the response.", "location": "query" }, "apiProduct": { "description": "API product.", "location": "query", "type": "string" }, "keyStatus": { "description": "Optional. Key status of the app. Valid values include `approved` or `revoked`. Defaults to `approved`.", "location": "query", "type": "string" }, "filter": { "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.", "location": "query", "type": "string" }, "apptype": { "type": "string", "description": "Optional. 'apptype' is no longer available. Use a 'filter' instead.", "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).", "path": "v1/{+parent}/apps", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ListAppsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.apps.list", "flatPath": "v1/organizations/{organizationsId}/apps" } } }, "dnsZones": { "methods": { "get": { "id": "apigee.organizations.dnsZones.get", "flatPath": "v1/organizations/{organizationsId}/dnsZones/{dnsZonesId}", "response": { "$ref": "GoogleCloudApigeeV1DnsZone" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "required": true, "location": "path", "type": "string", "description": "Required. Name of the DNS zone to fetch. Use the following structure in your request: `organizations/{org}/dnsZones/{dns_zone}`.", "pattern": "^organizations/[^/]+/dnsZones/[^/]+$" } }, "description": "Fetches the representation of an existing DNS zone." }, "delete": { "path": "v1/{+name}", "parameters": { "name": { "location": "path", "type": "string", "required": true, "description": "Required. Name of the DNS zone to delete. Use the following structure in your request: `organizations/{org}/dnsZones/{dns_zone}`.", "pattern": "^organizations/[^/]+/dnsZones/[^/]+$" } }, "description": "Deletes a previously created DNS zone.", "httpMethod": "DELETE", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/dnsZones/{dnsZonesId}", "id": "apigee.organizations.dnsZones.delete" }, "create": { "id": "apigee.organizations.dnsZones.create", "flatPath": "v1/organizations/{organizationsId}/dnsZones", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "path": "v1/{+parent}/dnsZones", "httpMethod": "POST", "parameters": { "parent": { "type": "string", "location": "path", "required": true, "description": "Required. Organization where the DNS zone will be created.", "pattern": "^organizations/[^/]+$" }, "dnsZoneId": { "type": "string", "description": "Required. User assigned ID for this resource. Must be unique within the organization. The name must be 1-63 characters long, must begin with a letter, end with a letter or digit, and only contain lowercase letters, digits or dashes.", "location": "query" } }, "description": "Creates a new DNS zone.", "request": { "$ref": "GoogleCloudApigeeV1DnsZone" } }, "list": { "response": { "$ref": "GoogleCloudApigeeV1ListDnsZonesResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "id": "apigee.organizations.dnsZones.list", "flatPath": "v1/organizations/{organizationsId}/dnsZones", "path": "v1/{+parent}/dnsZones", "httpMethod": "GET", "parameters": { "pageSize": { "format": "int32", "type": "integer", "description": "Optional. Maximum number of DNS zones to return. If unspecified, at most 25 DNS zones will be returned.", "location": "query" }, "pageToken": { "description": "Optional. Page token, returned from a previous `ListDnsZones` call, that you can use to retrieve the next page.", "location": "query", "type": "string" }, "parent": { "description": "Required. Name of the organization for which to list the DNS zones. Use the following structure in your request: `organizations/{org}`", "pattern": "^organizations/[^/]+$", "required": true, "type": "string", "location": "path" } }, "description": "Enumerates DNS zones that have been created but not yet deleted." } } }, "environments": { "resources": { "references": { "methods": { "delete": { "response": { "$ref": "GoogleCloudApigeeV1Reference" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/references/{referencesId}", "id": "apigee.organizations.environments.references.delete", "path": "v1/{+name}", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. The name of the Reference to delete. Must be of the form `organizations/{org}/environments/{env}/references/{ref}`.", "pattern": "^organizations/[^/]+/environments/[^/]+/references/[^/]+$" } }, "description": "Deletes a Reference from an environment. Returns the deleted Reference resource.", "httpMethod": "DELETE" }, "get": { "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. The name of the Reference to get. Must be of the form `organizations/{org}/environments/{env}/references/{ref}`.", "pattern": "^organizations/[^/]+/environments/[^/]+/references/[^/]+$" } }, "description": "Gets a Reference resource.", "response": { "$ref": "GoogleCloudApigeeV1Reference" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.environments.references.get", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/references/{referencesId}" }, "update": { "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/references/{referencesId}", "id": "apigee.organizations.environments.references.update", "response": { "$ref": "GoogleCloudApigeeV1Reference" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}", "parameters": { "name": { "required": true, "location": "path", "type": "string", "description": "Required. The name of the Reference to update. Must be of the form `organizations/{org}/environments/{env}/references/{ref}`.", "pattern": "^organizations/[^/]+/environments/[^/]+/references/[^/]+$" } }, "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", "request": { "$ref": "GoogleCloudApigeeV1Reference" } }, "create": { "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/references", "id": "apigee.organizations.environments.references.create", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1Reference" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "required": true, "location": "path", "type": "string", "description": "Required. The parent environment name under which the Reference will be created. Must be of the form `organizations/{org}/environments/{env}`.", "pattern": "^organizations/[^/]+/environments/[^/]+$" } }, "description": "Creates a Reference in the specified environment.", "httpMethod": "POST", "path": "v1/{+parent}/references", "request": { "$ref": "GoogleCloudApigeeV1Reference" } } } }, "stats": { "methods": { "get": { "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "aggTable": { "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.", "location": "query" }, "realtime": { "type": "boolean", "description": "No longer used by Apigee. Supported for backwards compatibility.", "location": "query" }, "tsAscending": { "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", "type": "boolean" }, "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" }, "sortby": { "type": "string", "description": "Comma-separated list of metrics to sort the final result.", "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" }, "limit": { "description": "Maximum number of result items to return.", "location": "query", "type": "string" }, "timeUnit": { "type": "string", "description": "Granularity of metrics returned. Valid values include: `second`, `minute`, `hour`, `day`, `week`, or` month`.", "location": "query" }, "sonar": { "type": "boolean", "description": "Routes the query to API Monitoring for the last hour.", "location": "query" }, "filter": { "description": "Filter that enables you to drill down on specific dimension values.", "location": "query", "type": "string" }, "select": { "type": "string", "description": "Comma-separated list of metrics. For example: `sum(message_count),sum(error_count)`", "location": "query" }, "accuracy": { "type": "string", "description": "No longer used by Apigee. Supported for backwards compatibility.", "location": "query" }, "name": { "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`", "pattern": "^organizations/[^/]+/environments/[^/]+/stats/.*$", "type": "string", "location": "path", "required": true }, "sort": { "type": "string", "description": "Flag that specifies whether the sort order should be ascending or descending. Valid values include: `DESC` and `ASC`.", "location": "query" }, "timeRange": { "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`", "location": "query" }, "tzo": { "type": "string", "description": "Timezone offset value.", "location": "query" } }, "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.", "response": { "$ref": "GoogleCloudApigeeV1Stats" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.environments.stats.get", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/stats/{statsId}" } } }, "targetservers": { "methods": { "get": { "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/targetservers/{targetserversId}", "id": "apigee.organizations.environments.targetservers.get", "response": { "$ref": "GoogleCloudApigeeV1TargetServer" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}", "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Required. The name of the TargetServer to get. Must be of the form `organizations/{org}/environments/{env}/targetservers/{target_server_id}`.", "pattern": "^organizations/[^/]+/environments/[^/]+/targetservers/[^/]+$" } }, "description": "Gets a TargetServer resource.", "httpMethod": "GET" }, "update": { "id": "apigee.organizations.environments.targetservers.update", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/targetservers/{targetserversId}", "response": { "$ref": "GoogleCloudApigeeV1TargetServer" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "PUT", "parameters": { "name": { "description": "Required. The name of the TargetServer to replace. Must be of the form `organizations/{org}/environments/{env}/targetservers/{target_server_id}`.", "pattern": "^organizations/[^/]+/environments/[^/]+/targetservers/[^/]+$", "location": "path", "type": "string", "required": true } }, "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.", "request": { "$ref": "GoogleCloudApigeeV1TargetServer" } }, "delete": { "id": "apigee.organizations.environments.targetservers.delete", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/targetservers/{targetserversId}", "response": { "$ref": "GoogleCloudApigeeV1TargetServer" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "DELETE", "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/[^/]+$", "required": true, "location": "path", "type": "string" } }, "description": "Deletes a TargetServer from an environment. Returns the deleted TargetServer resource." }, "create": { "id": "apigee.organizations.environments.targetservers.create", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/targetservers", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1TargetServer" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "parent": { "description": "Required. The parent environment name under which the TargetServer will be created. Must be of the form `organizations/{org}/environments/{env}`.", "pattern": "^organizations/[^/]+/environments/[^/]+$", "type": "string", "location": "path", "required": true }, "name": { "type": "string", "description": "Optional. The ID to give the TargetServer. This will overwrite the value in TargetServer.", "location": "query" } }, "description": "Creates a TargetServer in the specified environment.", "path": "v1/{+parent}/targetservers", "request": { "$ref": "GoogleCloudApigeeV1TargetServer" } } } }, "securityStats": { "methods": { "queryTabularStats": { "parameterOrder": [ "orgenv" ], "response": { "$ref": "GoogleCloudApigeeV1QueryTabularStatsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityStats:queryTabularStats", "id": "apigee.organizations.environments.securityStats.queryTabularStats", "request": { "$ref": "GoogleCloudApigeeV1QueryTabularStatsRequest" }, "parameters": { "orgenv": { "location": "path", "type": "string", "required": true, "description": "Required. Should be of the form organizations//environments/.", "pattern": "^organizations/[^/]+/environments/[^/]+$" } }, "description": "Retrieve security statistics as tabular rows.", "httpMethod": "POST", "path": "v1/{+orgenv}/securityStats:queryTabularStats" }, "queryTimeSeriesStats": { "parameterOrder": [ "orgenv" ], "response": { "$ref": "GoogleCloudApigeeV1QueryTimeSeriesStatsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityStats:queryTimeSeriesStats", "id": "apigee.organizations.environments.securityStats.queryTimeSeriesStats", "request": { "$ref": "GoogleCloudApigeeV1QueryTimeSeriesStatsRequest" }, "parameters": { "orgenv": { "description": "Required. Should be of the form organizations//environments/.", "pattern": "^organizations/[^/]+/environments/[^/]+$", "type": "string", "location": "path", "required": true } }, "description": "Retrieve security statistics as a collection of time series.", "httpMethod": "POST", "path": "v1/{+orgenv}/securityStats:queryTimeSeriesStats" } } }, "flowhooks": { "methods": { "get": { "response": { "$ref": "GoogleCloudApigeeV1FlowHook" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.environments.flowhooks.get", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/flowhooks/{flowhooksId}", "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "description": "Required. Name of the flow hook in the following format: `organizations/{org}/environments/{env}/flowhooks/{flowhook}`", "pattern": "^organizations/[^/]+/environments/[^/]+/flowhooks/[^/]+$", "required": true, "location": "path", "type": "string" } }, "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." }, "attachSharedFlowToFlowHook": { "request": { "$ref": "GoogleCloudApigeeV1FlowHook" }, "parameters": { "name": { "location": "path", "type": "string", "required": true, "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", "path": "v1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1FlowHook" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/flowhooks/{flowhooksId}", "id": "apigee.organizations.environments.flowhooks.attachSharedFlowToFlowHook" }, "detachSharedFlowFromFlowHook": { "httpMethod": "DELETE", "parameters": { "name": { "description": "Required. Name of the flow hook to detach in the following format: `organizations/{org}/environments/{env}/flowhooks/{flowhook}`", "pattern": "^organizations/[^/]+/environments/[^/]+/flowhooks/[^/]+$", "type": "string", "location": "path", "required": true } }, "description": "Detaches a shared flow from a flow hook.", "path": "v1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1FlowHook" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.environments.flowhooks.detachSharedFlowFromFlowHook", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/flowhooks/{flowhooksId}" } } }, "securityIncidents": { "methods": { "get": { "response": { "$ref": "GoogleCloudApigeeV1SecurityIncident" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.environments.securityIncidents.get", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityIncidents/{securityIncidentsId}", "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "description": "Required. Security incident in the following format: `organizations/{org}/environments/{environment}/securityIncidents/{incident}'. Example: organizations/testOrg/environments/testEnv/securityIncidents/1234-4567-890-111", "pattern": "^organizations/[^/]+/environments/[^/]+/securityIncidents/[^/]+$", "type": "string", "location": "path", "required": true } }, "description": "GetSecurityIncident gets the specified security incident. Returns NOT_FOUND if security incident is not present for the specified organization and environment." }, "batchUpdate": { "id": "apigee.organizations.environments.securityIncidents.batchUpdate", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityIncidents:batchUpdate", "response": { "$ref": "GoogleCloudApigeeV1BatchUpdateSecurityIncidentsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "path": "v1/{+parent}/securityIncidents:batchUpdate", "httpMethod": "POST", "parameters": { "parent": { "required": true, "type": "string", "location": "path", "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.", "pattern": "^organizations/[^/]+/environments/[^/]+$" } }, "description": "BatchUpdateSecurityIncident updates multiple existing security incidents.", "request": { "$ref": "GoogleCloudApigeeV1BatchUpdateSecurityIncidentsRequest" } }, "list": { "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ListSecurityIncidentsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.environments.securityIncidents.list", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityIncidents", "httpMethod": "GET", "parameters": { "pageSize": { "type": "integer", "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.", "location": "query", "format": "int32" }, "pageToken": { "type": "string", "description": "Optional. A page token, received from a previous `ListSecurityIncident` call. Provide this to retrieve the subsequent page.", "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" }, "parent": { "description": "Required. For a specific organization, list of all the security incidents. Format: `organizations/{org}/environments/{environment}`", "pattern": "^organizations/[^/]+/environments/[^/]+$", "type": "string", "location": "path", "required": true } }, "description": "ListSecurityIncidents lists all the security incident associated with the environment.", "path": "v1/{+parent}/securityIncidents" }, "patch": { "httpMethod": "PATCH", "parameters": { "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", "pattern": "^organizations/[^/]+/environments/[^/]+/securityIncidents/[^/]+$", "required": true, "location": "path", "type": "string" }, "updateMask": { "description": "Required. The list of fields to update. Allowed fields are: LINT.IfChange(allowed_update_fields_comment) - observability LINT.ThenChange()", "location": "query", "type": "string", "format": "google-fieldmask" } }, "description": "UpdateSecurityIncidents updates an existing security incident.", "path": "v1/{+name}", "request": { "$ref": "GoogleCloudApigeeV1SecurityIncident" }, "id": "apigee.organizations.environments.securityIncidents.patch", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityIncidents/{securityIncidentsId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1SecurityIncident" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } }, "archiveDeployments": { "methods": { "list": { "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/archiveDeployments", "id": "apigee.organizations.environments.archiveDeployments.list", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ListArchiveDeploymentsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "required": true, "location": "path", "type": "string", "description": "Required. Name of the Environment for which to list Archive Deployments in the format: `organizations/{org}/environments/{env}`.", "pattern": "^organizations/[^/]+/environments/[^/]+$" }, "pageSize": { "format": "int32", "type": "integer", "description": "Optional. Maximum number of Archive Deployments to return. If unspecified, at most 25 deployments will be returned.", "location": "query" }, "pageToken": { "description": "Optional. Page token, returned from a previous ListArchiveDeployments call, that you can use to retrieve the next page.", "location": "query", "type": "string" }, "filter": { "description": "Optional. An optional query used to return a subset of Archive Deployments using the semantics defined in https://google.aip.dev/160.", "location": "query", "type": "string" } }, "description": "Lists the ArchiveDeployments in the specified Environment.", "httpMethod": "GET", "path": "v1/{+parent}/archiveDeployments" }, "generateUploadUrl": { "path": "v1/{+parent}/archiveDeployments:generateUploadUrl", "parameters": { "parent": { "type": "string", "location": "path", "required": true, "description": "Required. The organization and environment to upload to.", "pattern": "^organizations/[^/]+/environments/[^/]+$" } }, "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`", "httpMethod": "POST", "request": { "$ref": "GoogleCloudApigeeV1GenerateUploadUrlRequest" }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/archiveDeployments:generateUploadUrl", "id": "apigee.organizations.environments.archiveDeployments.generateUploadUrl", "response": { "$ref": "GoogleCloudApigeeV1GenerateUploadUrlResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ] }, "create": { "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/archiveDeployments", "id": "apigee.organizations.environments.archiveDeployments.create", "request": { "$ref": "GoogleCloudApigeeV1ArchiveDeployment" }, "path": "v1/{+parent}/archiveDeployments", "parameters": { "parent": { "description": "Required. The Environment this Archive Deployment will be created in.", "pattern": "^organizations/[^/]+/environments/[^/]+$", "required": true, "type": "string", "location": "path" } }, "description": "Creates a new ArchiveDeployment.", "httpMethod": "POST" }, "delete": { "id": "apigee.organizations.environments.archiveDeployments.delete", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/archiveDeployments/{archiveDeploymentsId}", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "DELETE", "parameters": { "name": { "description": "Required. Name of the Archive Deployment in the following format: `organizations/{org}/environments/{env}/archiveDeployments/{id}`.", "pattern": "^organizations/[^/]+/environments/[^/]+/archiveDeployments/[^/]+$", "required": true, "type": "string", "location": "path" } }, "description": "Deletes an archive deployment." }, "generateDownloadUrl": { "httpMethod": "POST", "parameters": { "name": { "description": "Required. The name of the Archive Deployment you want to download.", "pattern": "^organizations/[^/]+/environments/[^/]+/archiveDeployments/[^/]+$", "required": true, "location": "path", "type": "string" } }, "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.", "path": "v1/{+name}:generateDownloadUrl", "request": { "$ref": "GoogleCloudApigeeV1GenerateDownloadUrlRequest" }, "id": "apigee.organizations.environments.archiveDeployments.generateDownloadUrl", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/archiveDeployments/{archiveDeploymentsId}:generateDownloadUrl", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1GenerateDownloadUrlResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "patch": { "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/archiveDeployments/{archiveDeploymentsId}", "id": "apigee.organizations.environments.archiveDeployments.patch", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1ArchiveDeployment" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "Name of the Archive Deployment in the following format: `organizations/{org}/environments/{env}/archiveDeployments/{id}`.", "pattern": "^organizations/[^/]+/environments/[^/]+/archiveDeployments/[^/]+$", "required": true, "location": "path", "type": "string" }, "updateMask": { "format": "google-fieldmask", "description": "Required. The list of fields to be updated.", "location": "query", "type": "string" } }, "description": "Updates an existing ArchiveDeployment. Labels can modified but most of the other fields are not modifiable.", "httpMethod": "PATCH", "path": "v1/{+name}", "request": { "$ref": "GoogleCloudApigeeV1ArchiveDeployment" } }, "get": { "parameters": { "name": { "location": "path", "type": "string", "required": true, "description": "Required. Name of the Archive Deployment in the following format: `organizations/{org}/environments/{env}/archiveDeployments/{id}`.", "pattern": "^organizations/[^/]+/environments/[^/]+/archiveDeployments/[^/]+$" } }, "description": "Gets the specified ArchiveDeployment.", "httpMethod": "GET", "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/archiveDeployments/{archiveDeploymentsId}", "id": "apigee.organizations.environments.archiveDeployments.get", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1ArchiveDeployment" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } }, "traceConfig": { "resources": { "overrides": { "methods": { "create": { "request": { "$ref": "GoogleCloudApigeeV1TraceConfigOverride" }, "path": "v1/{+parent}/overrides", "httpMethod": "POST", "parameters": { "parent": { "description": "Required. Parent resource of the trace configuration override. Use the following structure in your request. \"organizations/*/environments/*/traceConfig\".", "pattern": "^organizations/[^/]+/environments/[^/]+/traceConfig$", "required": true, "type": "string", "location": "path" } }, "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.", "response": { "$ref": "GoogleCloudApigeeV1TraceConfigOverride" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "id": "apigee.organizations.environments.traceConfig.overrides.create", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/traceConfig/overrides" }, "list": { "parameters": { "parent": { "required": true, "location": "path", "type": "string", "description": "Required. Parent resource of the trace configuration override. Use the following structure in your request: \"organizations/*/environments/*/traceConfig\".", "pattern": "^organizations/[^/]+/environments/[^/]+/traceConfig$" }, "pageSize": { "format": "int32", "description": "Maximum number of trace configuration overrides to return. If not specified, the maximum number returned is 25. The maximum number cannot exceed 100.", "location": "query", "type": "integer" }, "pageToken": { "type": "string", "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" } }, "description": "Lists all of the distributed trace configuration overrides in an environment.", "httpMethod": "GET", "path": "v1/{+parent}/overrides", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/traceConfig/overrides", "id": "apigee.organizations.environments.traceConfig.overrides.list", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ListTraceConfigOverridesResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "id": "apigee.organizations.environments.traceConfig.overrides.delete", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/traceConfig/overrides/{overridesId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. Name of the trace configuration override. Use the following structure in your request: \"organizations/*/environments/*/traceConfig/overrides/*\".", "pattern": "^organizations/[^/]+/environments/[^/]+/traceConfig/overrides/[^/]+$" } }, "description": "Deletes a distributed trace configuration override.", "path": "v1/{+name}" }, "patch": { "request": { "$ref": "GoogleCloudApigeeV1TraceConfigOverride" }, "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. Name of the trace configuration override. Use the following structure in your request: \"organizations/*/environments/*/traceConfig/overrides/*\".", "pattern": "^organizations/[^/]+/environments/[^/]+/traceConfig/overrides/[^/]+$" }, "updateMask": { "type": "string", "description": "List of fields to be updated.", "location": "query", "format": "google-fieldmask" } }, "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.", "httpMethod": "PATCH", "path": "v1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1TraceConfigOverride" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/traceConfig/overrides/{overridesId}", "id": "apigee.organizations.environments.traceConfig.overrides.patch" }, "get": { "id": "apigee.organizations.environments.traceConfig.overrides.get", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/traceConfig/overrides/{overridesId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1TraceConfigOverride" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "name": { "required": true, "location": "path", "type": "string", "description": "Required. Name of the trace configuration override. Use the following structure in your request: \"organizations/*/environments/*/traceConfig/overrides/*\".", "pattern": "^organizations/[^/]+/environments/[^/]+/traceConfig/overrides/[^/]+$" } }, "description": "Gets a trace configuration override.", "path": "v1/{+name}" } } } } }, "optimizedStats": { "methods": { "get": { "path": "v1/{+name}", "parameters": { "sonar": { "type": "boolean", "description": "Routes the query to API Monitoring for the last hour.", "location": "query" }, "filter": { "description": "Filter that enables you to drill-down on specific dimension values.", "location": "query", "type": "string" }, "select": { "description": "Required. Comma-separated list of metrics. For example: `sum(message_count),sum(error_count)`", "location": "query", "type": "string" }, "accuracy": { "description": "No longer used by Apigee. Supported for backwards compatibility.", "location": "query", "type": "string" }, "name": { "required": true, "location": "path", "type": "string", "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`", "pattern": "^organizations/[^/]+/environments/[^/]+/optimizedStats/.*$" }, "sort": { "description": "Flag that specifies whether the sort order should be ascending or descending. Valid values include `DESC` and `ASC`.", "location": "query", "type": "string" }, "timeRange": { "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`", "location": "query", "type": "string" }, "tzo": { "description": "Timezone offset value.", "location": "query", "type": "string" }, "aggTable": { "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.", "location": "query", "type": "string" }, "realtime": { "description": "No longer used by Apigee. Supported for backwards compatibility.", "location": "query", "type": "boolean" }, "tsAscending": { "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`.", "location": "query", "type": "boolean" }, "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`.", "location": "query", "type": "string" }, "sortby": { "type": "string", "description": "Comma-separated list of metrics to sort the final result.", "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" }, "limit": { "description": "Maximum number of result items to return.", "location": "query", "type": "string" }, "timeUnit": { "description": "Granularity of metrics returned. Valid values include: `second`, `minute`, `hour`, `day`, `week`, or `month`.", "location": "query", "type": "string" } }, "description": "Similar to GetStats except that the response is less verbose.", "httpMethod": "GET", "response": { "$ref": "GoogleCloudApigeeV1OptimizedStats" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/optimizedStats/{optimizedStatsId}", "id": "apigee.organizations.environments.optimizedStats.get" } } }, "queries": { "methods": { "get": { "response": { "$ref": "GoogleCloudApigeeV1AsyncQuery" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.environments.queries.get", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/queries/{queriesId}", "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Required. Name of the asynchronous query to get. Must be of the form `organizations/{org}/environments/{env}/queries/{queryId}`.", "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\"" }, "getResult": { "response": { "$ref": "GoogleApiHttpBody" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.environments.queries.getResult", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/queries/{queriesId}/result", "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "description": "Required. Name of the asynchronous query result to get. Must be of the form `organizations/{org}/environments/{env}/queries/{queryId}/result`.", "pattern": "^organizations/[^/]+/environments/[^/]+/queries/[^/]+/result$", "required": true, "location": "path", "type": "string" } }, "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`" }, "getResulturl": { "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. Name of the asynchronous query result to get. Must be of the form `organizations/{org}/environments/{env}/queries/{queryId}/resulturl`.", "pattern": "^organizations/[^/]+/environments/[^/]+/queries/[^/]+/resulturl$" } }, "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.", "httpMethod": "GET", "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/queries/{queriesId}/resulturl", "id": "apigee.organizations.environments.queries.getResulturl", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1GetAsyncQueryResultUrlResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "create": { "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/queries", "id": "apigee.organizations.environments.queries.create", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1AsyncQuery" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "description": "Required. The parent resource name. Must be of the form `organizations/{org}/environments/{env}`.", "pattern": "^organizations/[^/]+/environments/[^/]+$", "location": "path", "type": "string", "required": true } }, "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.", "httpMethod": "POST", "path": "v1/{+parent}/queries", "request": { "$ref": "GoogleCloudApigeeV1Query" } }, "list": { "path": "v1/{+parent}/queries", "httpMethod": "GET", "parameters": { "status": { "type": "string", "description": "Filter response list by asynchronous query status.", "location": "query" }, "from": { "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'.", "location": "query" }, "dataset": { "description": "Filter response list by dataset. Example: `api`, `mint`", "location": "query", "type": "string" }, "inclQueriesWithoutReport": { "type": "string", "description": "Flag to include asynchronous queries that don't have a report denifition.", "location": "query" }, "submittedBy": { "description": "Filter response list by user who submitted queries.", "location": "query", "type": "string" }, "to": { "type": "string", "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" }, "parent": { "type": "string", "location": "path", "required": true, "description": "Required. The parent resource name. Must be of the form `organizations/{org}/environments/{env}`.", "pattern": "^organizations/[^/]+/environments/[^/]+$" } }, "description": "Return a list of Asynchronous Queries", "response": { "$ref": "GoogleCloudApigeeV1ListAsyncQueriesResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "id": "apigee.organizations.environments.queries.list", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/queries" } } }, "caches": { "methods": { "delete": { "path": "v1/{+name}", "httpMethod": "DELETE", "parameters": { "name": { "description": "Required. Cache resource name of the form: `organizations/{organization_id}/environments/{environment_id}/caches/{cache_id}`", "pattern": "^organizations/[^/]+/environments/[^/]+/caches/[^/]+$", "required": true, "type": "string", "location": "path" } }, "description": "Deletes a cache.", "id": "apigee.organizations.environments.caches.delete", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/caches/{cachesId}", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] } } }, "keystores": { "methods": { "get": { "response": { "$ref": "GoogleCloudApigeeV1Keystore" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.environments.keystores.get", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keystores/{keystoresId}", "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "location": "path", "type": "string", "required": true, "description": "Required. Name of the keystore. Use the following format in your request: `organizations/{org}/environments/{env}/keystores/{keystore}`.", "pattern": "^organizations/[^/]+/environments/[^/]+/keystores/[^/]+$" } }, "description": "Gets a keystore or truststore." }, "delete": { "id": "apigee.organizations.environments.keystores.delete", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keystores/{keystoresId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1Keystore" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "parameters": { "name": { "required": true, "location": "path", "type": "string", "description": "Required. Name of the keystore. Use the following format in your request: `organizations/{org}/environments/{env}/keystores/{keystore}`", "pattern": "^organizations/[^/]+/environments/[^/]+/keystores/[^/]+$" } }, "description": "Deletes a keystore or truststore.", "path": "v1/{+name}" }, "create": { "response": { "$ref": "GoogleCloudApigeeV1Keystore" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "id": "apigee.organizations.environments.keystores.create", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keystores", "request": { "$ref": "GoogleCloudApigeeV1Keystore" }, "path": "v1/{+parent}/keystores", "httpMethod": "POST", "parameters": { "parent": { "description": "Required. Name of the environment in which to create the keystore. Use the following format in your request: `organizations/{org}/environments/{env}`", "pattern": "^organizations/[^/]+/environments/[^/]+$", "type": "string", "location": "path", "required": true }, "name": { "type": "string", "description": "Optional. Name of the keystore. Overrides the value in Keystore.", "location": "query" } }, "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." } }, "resources": { "aliases": { "methods": { "csr": { "path": "v1/{+name}/csr", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. Name of the alias. Use the following format in your request: `organizations/{org}/environments/{env}/keystores/{keystore}/aliases/{alias}`.", "pattern": "^organizations/[^/]+/environments/[^/]+/keystores/[^/]+/aliases/[^/]+$" } }, "description": "Generates a PKCS #10 Certificate Signing Request for the private key in an alias.", "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keystores/{keystoresId}/aliases/{aliasesId}/csr", "id": "apigee.organizations.environments.keystores.aliases.csr", "response": { "$ref": "GoogleApiHttpBody" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "getCertificate": { "parameters": { "name": { "required": true, "location": "path", "type": "string", "description": "Required. Name of the alias. Use the following format in your request: `organizations/{org}/environments/{env}/keystores/{keystore}/aliases/{alias}`.", "pattern": "^organizations/[^/]+/environments/[^/]+/keystores/[^/]+/aliases/[^/]+$" } }, "description": "Gets the certificate from an alias in PEM-encoded form.", "httpMethod": "GET", "path": "v1/{+name}/certificate", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleApiHttpBody" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keystores/{keystoresId}/aliases/{aliasesId}/certificate", "id": "apigee.organizations.environments.keystores.aliases.getCertificate" }, "create": { "parameters": { "format": { "description": "Required. Format of the data. Valid values include: `selfsignedcert`, `keycertfile`, or `pkcs12`", "location": "query", "type": "string" }, "alias": { "type": "string", "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" }, "ignoreExpiryValidation": { "description": "Flag that specifies whether to ignore expiry validation. If set to `true`, no expiry validation will be performed.", "location": "query", "type": "boolean" }, "_password": { "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", "type": "string" }, "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`.", "location": "query", "type": "boolean" }, "parent": { "description": "Required. Name of the keystore. Use the following format in your request: `organizations/{org}/environments/{env}/keystores/{keystore}`.", "pattern": "^organizations/[^/]+/environments/[^/]+/keystores/[^/]+$", "type": "string", "location": "path", "required": true } }, "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.", "httpMethod": "POST", "path": "v1/{+parent}/aliases", "request": { "$ref": "GoogleApiHttpBody" }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keystores/{keystoresId}/aliases", "id": "apigee.organizations.environments.keystores.aliases.create", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1Alias" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "id": "apigee.organizations.environments.keystores.aliases.delete", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keystores/{keystoresId}/aliases/{aliasesId}", "response": { "$ref": "GoogleCloudApigeeV1Alias" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "DELETE", "parameters": { "name": { "description": "Required. Name of the alias. Use the following format in your request: `organizations/{org}/environments/{env}/keystores/{keystore}/aliases/{alias}`.", "pattern": "^organizations/[^/]+/environments/[^/]+/keystores/[^/]+/aliases/[^/]+$", "required": true, "type": "string", "location": "path" } }, "description": "Deletes an alias." }, "get": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1Alias" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.environments.keystores.aliases.get", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keystores/{keystoresId}/aliases/{aliasesId}", "httpMethod": "GET", "parameters": { "name": { "required": true, "location": "path", "type": "string", "description": "Required. Name of the alias. Use the following format in your request: `organizations/{org}/environments/{env}/keystores/{keystore}/aliases/{alias}`.", "pattern": "^organizations/[^/]+/environments/[^/]+/keystores/[^/]+/aliases/[^/]+$" } }, "description": "Gets an alias.", "path": "v1/{+name}" }, "update": { "parameters": { "ignoreExpiryValidation": { "description": "Required. Flag that specifies whether to ignore expiry validation. If set to `true`, no expiry validation will be performed.", "location": "query", "type": "boolean" }, "name": { "type": "string", "location": "path", "required": true, "description": "Required. Name of the alias. Use the following format in your request: `organizations/{org}/environments/{env}/keystores/{keystore}/aliases/{alias}`", "pattern": "^organizations/[^/]+/environments/[^/]+/keystores/[^/]+/aliases/[^/]+$" }, "ignoreNewlineValidation": { "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`.", "location": "query" } }, "description": "Updates the certificate in an alias. The updated certificate must be in PEM- or DER-encoded X.509 format.", "httpMethod": "PUT", "path": "v1/{+name}", "request": { "$ref": "GoogleApiHttpBody" }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keystores/{keystoresId}/aliases/{aliasesId}", "id": "apigee.organizations.environments.keystores.aliases.update", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1Alias" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } } } }, "addonsConfig": { "methods": { "setAddonEnablement": { "id": "apigee.organizations.environments.addonsConfig.setAddonEnablement", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/addonsConfig:setAddonEnablement", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}:setAddonEnablement", "httpMethod": "POST", "parameters": { "name": { "description": "Required. Name of the add-ons config. Must be in the format of `/organizations/{org}/environments/{env}/addonsConfig`", "pattern": "^organizations/[^/]+/environments/[^/]+/addonsConfig$", "type": "string", "location": "path", "required": true } }, "description": "Updates an add-on enablement status of an environment.", "request": { "$ref": "GoogleCloudApigeeV1SetAddonEnablementRequest" } } } }, "analytics": { "resources": { "admin": { "methods": { "getSchemav2": { "httpMethod": "GET", "parameters": { "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" }, "type": { "type": "string", "description": "Required. Name of the dataset for which you want to retrieve the schema. For example: `fact` or `agg_cus1`", "location": "query" }, "name": { "description": "Required. Path to the schema. Use the following structure in your request: `organizations/{org}/environments/{env}/analytics/admin/schemav2`.", "pattern": "^organizations/[^/]+/environments/[^/]+/analytics/admin/schemav2$", "required": true, "location": "path", "type": "string" } }, "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.", "path": "v1/{+name}", "id": "apigee.organizations.environments.analytics.admin.getSchemav2", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/analytics/admin/schemav2", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1Schema" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } }, "exports": { "methods": { "create": { "response": { "$ref": "GoogleCloudApigeeV1Export" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/analytics/exports", "id": "apigee.organizations.environments.analytics.exports.create", "request": { "$ref": "GoogleCloudApigeeV1ExportRequest" }, "path": "v1/{+parent}/analytics/exports", "parameters": { "parent": { "type": "string", "location": "path", "required": true, "description": "Required. Names of the parent organization and environment. Must be of the form `organizations/{org}/environments/{env}`.", "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\".", "httpMethod": "POST" }, "list": { "parameters": { "parent": { "description": "Required. Names of the parent organization and environment. Must be of the form `organizations/{org}/environments/{env}`.", "pattern": "^organizations/[^/]+/environments/[^/]+$", "required": true, "location": "path", "type": "string" } }, "description": "Lists the details and status of all analytics export jobs belonging to the parent organization and environment.", "httpMethod": "GET", "path": "v1/{+parent}/analytics/exports", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ListExportsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/analytics/exports", "id": "apigee.organizations.environments.analytics.exports.list" }, "get": { "response": { "$ref": "GoogleCloudApigeeV1Export" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/analytics/exports/{exportsId}", "id": "apigee.organizations.environments.analytics.exports.get", "path": "v1/{+name}", "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Required. Resource name of the export to get.", "pattern": "^organizations/[^/]+/environments/[^/]+/analytics/exports/[^/]+$" } }, "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`.", "httpMethod": "GET" } } } } }, "apis": { "resources": { "revisions": { "methods": { "deploy": { "id": "apigee.organizations.environments.apis.revisions.deploy", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/apis/{apisId}/revisions/{revisionsId}/deployments", "response": { "$ref": "GoogleCloudApigeeV1Deployment" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}/deployments", "httpMethod": "POST", "parameters": { "serviceAccount": { "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`.", "location": "query", "type": "string" }, "name": { "type": "string", "location": "path", "required": true, "description": "Required. Name of the API proxy revision deployment in the following format: `organizations/{org}/environments/{env}/apis/{api}/revisions/{rev}` If the API proxy resource being deployed has the `space` attribute set, IAM permissions are checked differently . To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/environments/[^/]+/apis/[^/]+/revisions/[^/]+$" }, "override": { "type": "boolean", "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.", "location": "query" }, "sequencedRollout": { "type": "boolean", "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.", "location": "query" } }, "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}` All successful API proxy deployments to Apigee are [zero-downtime deployments](https://cloud.google.com/apigee/docs/api-platform/deploy/ui-deploy-overview#zero-downtime-deployment). Apigee hybrid validates the dependencies between shared flows and API proxies at deployment time. For example, if the Flow Callout policy in an API proxy references a shared flow that either doesn't exist or isn't deployed, the API proxy deployment fails." }, "undeploy": { "path": "v1/{+name}/deployments", "httpMethod": "DELETE", "parameters": { "name": { "description": "Required. Name of the API proxy revision deployment in the following format: `organizations/{org}/environments/{env}/apis/{api}/revisions/{rev}` If the API proxy resource has the `space` attribute set, IAM permissions are checked differently . To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/environments/[^/]+/apis/[^/]+/revisions/[^/]+$", "required": true, "location": "path", "type": "string" }, "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.", "location": "query", "type": "boolean" } }, "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}`", "id": "apigee.organizations.environments.apis.revisions.undeploy", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/apis/{apisId}/revisions/{revisionsId}/deployments", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "getDeployments": { "response": { "$ref": "GoogleCloudApigeeV1Deployment" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.environments.apis.revisions.getDeployments", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/apis/{apisId}/revisions/{revisionsId}/deployments", "path": "v1/{+name}/deployments", "httpMethod": "GET", "parameters": { "name": { "description": "Required. Name representing an API proxy revision in an environment in the following format: `organizations/{org}/environments/{env}/apis/{api}/revisions/{rev}` If the API proxy resource has the `space` attribute set, IAM permissions are checked differently . To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/environments/[^/]+/apis/[^/]+/revisions/[^/]+$", "location": "path", "type": "string", "required": true } }, "description": "Gets the deployment of an API proxy revision and actual state reported by runtime pods." } }, "resources": { "deployments": { "methods": { "generateDeployChangeReport": { "parameters": { "name": { "description": "Name of the API proxy revision deployment in the following format: `organizations/{org}/environments/{env}/apis/{api}/revisions/{rev}` If the API proxy resource has the `space` attribute set, IAM permissions are checked differently . To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/environments/[^/]+/apis/[^/]+/revisions/[^/]+$", "type": "string", "location": "path", "required": true }, "override": { "type": "boolean", "description": "Flag that specifies whether to force the deployment of the new revision over the currently deployed revision by overriding conflict checks.", "location": "query" } }, "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}`", "httpMethod": "POST", "path": "v1/{+name}/deployments:generateDeployChangeReport", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1DeploymentChangeReport" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/apis/{apisId}/revisions/{revisionsId}/deployments:generateDeployChangeReport", "id": "apigee.organizations.environments.apis.revisions.deployments.generateDeployChangeReport" }, "generateUndeployChangeReport": { "path": "v1/{+name}/deployments:generateUndeployChangeReport", "parameters": { "name": { "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/[^/]+$", "type": "string", "location": "path", "required": true } }, "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}`", "httpMethod": "POST", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/apis/{apisId}/revisions/{revisionsId}/deployments:generateUndeployChangeReport", "id": "apigee.organizations.environments.apis.revisions.deployments.generateUndeployChangeReport", "response": { "$ref": "GoogleCloudApigeeV1DeploymentChangeReport" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] } } }, "debugsessions": { "resources": { "data": { "methods": { "get": { "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/apis/{apisId}/revisions/{revisionsId}/debugsessions/{debugsessionsId}/data/{dataId}", "id": "apigee.organizations.environments.apis.revisions.debugsessions.data.get", "response": { "$ref": "GoogleCloudApigeeV1DebugSessionTransaction" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}", "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Required. The name of the debug session transaction. Must be of the form: `organizations/{organization}/environments/{environment}/apis/{api}/revisions/{revision}/debugsessions/{debug_session}/data/{transaction}`. If the API proxy resource has the `space` attribute set, IAM permissions are checked differently . To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/environments/[^/]+/apis/[^/]+/revisions/[^/]+/debugsessions/[^/]+/data/[^/]+$" } }, "description": "Gets the debug data from a transaction.", "httpMethod": "GET" } } } }, "methods": { "get": { "response": { "$ref": "GoogleCloudApigeeV1DebugSession" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.environments.apis.revisions.debugsessions.get", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/apis/{apisId}/revisions/{revisionsId}/debugsessions/{debugsessionsId}", "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Required. The name of the debug session to retrieve. Must be of the form: `organizations/{organization}/environments/{environment}/apis/{api}/revisions/{revision}/debugsessions/{debug_session}`. If the API proxy resource has the `space` attribute set, IAM permissions are checked differently . To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/environments/[^/]+/apis/[^/]+/revisions/[^/]+/debugsessions/[^/]+$" } }, "description": "Retrieves a debug session." }, "create": { "path": "v1/{+parent}/debugsessions", "httpMethod": "POST", "parameters": { "parent": { "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}`. If the API proxy resource has the `space` attribute set, IAM permissions are checked differently . To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/environments/[^/]+/apis/[^/]+/revisions/[^/]+$", "location": "path", "type": "string", "required": true }, "timeout": { "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", "format": "int64" } }, "description": "Creates a debug session for a deployed API Proxy revision.", "request": { "$ref": "GoogleCloudApigeeV1DebugSession" }, "id": "apigee.organizations.environments.apis.revisions.debugsessions.create", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/apis/{apisId}/revisions/{revisionsId}/debugsessions", "response": { "$ref": "GoogleCloudApigeeV1DebugSession" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ] }, "list": { "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ListDebugSessionsResponse" }, "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", "httpMethod": "GET", "parameters": { "pageSize": { "type": "integer", "description": "Optional. Maximum number of debug sessions to return. The page size defaults to 25.", "location": "query", "format": "int32" }, "pageToken": { "type": "string", "description": "Optional. 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", "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}`. If the API proxy resource has the `space` attribute set, IAM permissions are checked differently . To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/environments/[^/]+/apis/[^/]+/revisions/[^/]+$" } }, "description": "Lists debug sessions that are currently active in the given API Proxy revision.", "path": "v1/{+parent}/debugsessions" }, "deleteData": { "parameters": { "name": { "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}`. If the API proxy resource has the `space` attribute set, IAM permissions are checked differently . To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/environments/[^/]+/apis/[^/]+/revisions/[^/]+/debugsessions/[^/]+$", "location": "path", "type": "string", "required": true } }, "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.", "httpMethod": "DELETE", "path": "v1/{+name}/data", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/apis/{apisId}/revisions/{revisionsId}/debugsessions/{debugsessionsId}/data", "id": "apigee.organizations.environments.apis.revisions.debugsessions.deleteData" } } } } }, "deployments": { "methods": { "list": { "path": "v1/{+parent}/deployments", "httpMethod": "GET", "parameters": { "parent": { "location": "path", "type": "string", "required": true, "description": "Required. Name representing an API proxy in an environment in the following format: `organizations/{org}/environments/{env}/apis/{api}` If the API proxy resource has the `space` attribute set, IAM permissions are checked differently . To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/environments/[^/]+/apis/[^/]+$" } }, "description": "Lists all deployments of an API proxy in an environment.", "id": "apigee.organizations.environments.apis.deployments.list", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/apis/{apisId}/deployments", "response": { "$ref": "GoogleCloudApigeeV1ListDeploymentsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ] } } } } }, "deployments": { "methods": { "list": { "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/deployments", "id": "apigee.organizations.environments.deployments.list", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ListDeploymentsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "location": "path", "type": "string", "required": true, "description": "Required. Name of the environment for which to return deployment information in the following format: `organizations/{org}/environments/{env}`", "pattern": "^organizations/[^/]+/environments/[^/]+$" }, "sharedFlows": { "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", "type": "boolean" } }, "description": "Lists all deployments of API proxies or shared flows in an environment.", "httpMethod": "GET", "path": "v1/{+parent}/deployments" }, "getIamPolicy": { "id": "apigee.organizations.environments.deployments.getIamPolicy", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/deployments/{deploymentsId}:getIamPolicy", "parameterOrder": [ "resource" ], "response": { "$ref": "GoogleIamV1Policy" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "resource": { "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.", "pattern": "^organizations/[^/]+/environments/[^/]+/deployments/[^/]+$", "location": "path", "type": "string", "required": true }, "options.requestedPolicyVersion": { "format": "int32", "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", "type": "integer" } }, "description": "Gets the IAM policy on a deployment. 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.deployments.getIamPolicy` permission to call this API.", "path": "v1/{+resource}:getIamPolicy" }, "setIamPolicy": { "path": "v1/{+resource}:setIamPolicy", "parameters": { "resource": { "required": true, "type": "string", "location": "path", "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/[^/]+/deployments/[^/]+$" } }, "description": "Sets the IAM policy on a deployment, 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.deployments.setIamPolicy` permission to call this API.", "httpMethod": "POST", "request": { "$ref": "GoogleIamV1SetIamPolicyRequest" }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/deployments/{deploymentsId}:setIamPolicy", "id": "apigee.organizations.environments.deployments.setIamPolicy", "response": { "$ref": "GoogleIamV1Policy" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "resource" ] }, "get": { "response": { "$ref": "GoogleCloudApigeeV1Deployment" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/deployments/{deploymentsId}", "id": "apigee.organizations.environments.deployments.get", "path": "v1/{+name}", "parameters": { "name": { "description": "Required. Name of the api proxy or the shared flow deployment. Use the following structure in your request: `organizations/{org}/environments/{env}/deployments/{deployment}`", "pattern": "^organizations/[^/]+/environments/[^/]+/deployments/[^/]+$", "required": true, "type": "string", "location": "path" } }, "description": "Gets a particular deployment of Api proxy or a shared flow in an environment", "httpMethod": "GET" }, "testIamPermissions": { "parameterOrder": [ "resource" ], "response": { "$ref": "GoogleIamV1TestIamPermissionsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/deployments/{deploymentsId}:testIamPermissions", "id": "apigee.organizations.environments.deployments.testIamPermissions", "request": { "$ref": "GoogleIamV1TestIamPermissionsRequest" }, "parameters": { "resource": { "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.", "pattern": "^organizations/[^/]+/environments/[^/]+/deployments/[^/]+$", "type": "string", "location": "path", "required": true } }, "description": "Tests the permissions of a user on a deployment, and returns a subset of permissions that the user has on the deployment. If the deployment does not exist, an empty permission set is returned (a NOT_FOUND error is not returned).", "httpMethod": "POST", "path": "v1/{+resource}:testIamPermissions" } } }, "securityActions": { "methods": { "get": { "id": "apigee.organizations.environments.securityActions.get", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityActions/{securityActionsId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1SecurityAction" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "name": { "description": "Required. The fully qualified name of the SecurityAction to retrieve. Format: organizations/{org}/environments/{env}/securityActions/{security_action}", "pattern": "^organizations/[^/]+/environments/[^/]+/securityActions/[^/]+$", "required": true, "type": "string", "location": "path" } }, "description": "Get a SecurityAction by name.", "path": "v1/{+name}" }, "patch": { "request": { "$ref": "GoogleCloudApigeeV1SecurityAction" }, "path": "v1/{+name}", "httpMethod": "PATCH", "parameters": { "name": { "required": true, "type": "string", "location": "path", "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}", "pattern": "^organizations/[^/]+/environments/[^/]+/securityActions/[^/]+$" }, "updateMask": { "format": "google-fieldmask", "description": "Optional. The list of fields to update. Valid fields to update are `description`, `state`, `allow`, `deny`, and `flag`, `expire_time`, and `ttl`, `api_proxies`, and `condition_config`.", "location": "query", "type": "string" } }, "description": "Update a SecurityAction.", "response": { "$ref": "GoogleCloudApigeeV1SecurityAction" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.environments.securityActions.patch", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityActions/{securityActionsId}" }, "delete": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.environments.securityActions.delete", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityActions/{securityActionsId}", "httpMethod": "DELETE", "parameters": { "name": { "required": true, "location": "path", "type": "string", "description": "Required. The name of the security action to delete. Format: `organizations/{org}/environment/{env}/securityActions/{security_action}`", "pattern": "^organizations/[^/]+/environments/[^/]+/securityActions/[^/]+$" } }, "description": "Delete a SecurityAction.", "path": "v1/{+name}" }, "enable": { "response": { "$ref": "GoogleCloudApigeeV1SecurityAction" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityActions/{securityActionsId}:enable", "id": "apigee.organizations.environments.securityActions.enable", "request": { "$ref": "GoogleCloudApigeeV1EnableSecurityActionRequest" }, "path": "v1/{+name}:enable", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. The name of the SecurityAction to enable. Format: organizations/{org}/environments/{env}/securityActions/{security_action}", "pattern": "^organizations/[^/]+/environments/[^/]+/securityActions/[^/]+$" } }, "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" }, "disable": { "request": { "$ref": "GoogleCloudApigeeV1DisableSecurityActionRequest" }, "parameters": { "name": { "description": "Required. The name of the SecurityAction to disable. Format: organizations/{org}/environments/{env}/securityActions/{security_action}", "pattern": "^organizations/[^/]+/environments/[^/]+/securityActions/[^/]+$", "type": "string", "location": "path", "required": true } }, "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.", "httpMethod": "POST", "path": "v1/{+name}:disable", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1SecurityAction" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityActions/{securityActionsId}:disable", "id": "apigee.organizations.environments.securityActions.disable" }, "create": { "request": { "$ref": "GoogleCloudApigeeV1SecurityAction" }, "path": "v1/{+parent}/securityActions", "parameters": { "securityActionId": { "type": "string", "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])?$).", "location": "query" }, "parent": { "location": "path", "type": "string", "required": true, "description": "Required. The organization and environment that this SecurityAction applies to. Format: organizations/{org}/environments/{env}", "pattern": "^organizations/[^/]+/environments/[^/]+$" } }, "description": "CreateSecurityAction creates a SecurityAction.", "httpMethod": "POST", "response": { "$ref": "GoogleCloudApigeeV1SecurityAction" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityActions", "id": "apigee.organizations.environments.securityActions.create" }, "list": { "path": "v1/{+parent}/securityActions", "httpMethod": "GET", "parameters": { "parent": { "required": true, "location": "path", "type": "string", "description": "Required. The parent, which owns this collection of SecurityActions. Format: organizations/{org}/environments/{env}", "pattern": "^organizations/[^/]+/environments/[^/]+$" }, "pageSize": { "type": "integer", "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.", "location": "query", "format": "int32" }, "pageToken": { "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.", "location": "query", "type": "string" }, "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" } }, "description": "Returns a list of SecurityActions. This returns both enabled and disabled actions.", "response": { "$ref": "GoogleCloudApigeeV1ListSecurityActionsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "id": "apigee.organizations.environments.securityActions.list", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityActions" } } }, "securityReports": { "methods": { "create": { "parameters": { "parent": { "description": "Required. The parent resource name. Must be of the form `organizations/{org}/environments/{env}`.", "pattern": "^organizations/[^/]+/environments/[^/]+$", "required": true, "location": "path", "type": "string" } }, "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.", "httpMethod": "POST", "path": "v1/{+parent}/securityReports", "request": { "$ref": "GoogleCloudApigeeV1SecurityReportQuery" }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityReports", "id": "apigee.organizations.environments.securityReports.create", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1SecurityReport" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "path": "v1/{+parent}/securityReports", "parameters": { "pageToken": { "description": "Token returned from the previous list response to fetch the next page.", "location": "query", "type": "string" }, "from": { "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'.", "location": "query" }, "dataset": { "type": "string", "description": "Filter response list by dataset. Example: `api`, `mint`", "location": "query" }, "status": { "description": "Filter response list by security reports status.", "location": "query", "type": "string" }, "pageSize": { "description": "The maximum number of security report to return in the list response.", "location": "query", "type": "integer", "format": "int32" }, "parent": { "description": "Required. The parent resource name. Must be of the form `organizations/{org}/environments/{env}`.", "pattern": "^organizations/[^/]+/environments/[^/]+$", "type": "string", "location": "path", "required": true }, "submittedBy": { "description": "Filter response list by user who submitted queries.", "location": "query", "type": "string" }, "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'.", "location": "query", "type": "string" } }, "description": "Return a list of Security Reports", "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityReports", "id": "apigee.organizations.environments.securityReports.list", "response": { "$ref": "GoogleCloudApigeeV1ListSecurityReportsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ] }, "get": { "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityReports/{securityReportsId}", "id": "apigee.organizations.environments.securityReports.get", "response": { "$ref": "GoogleCloudApigeeV1SecurityReport" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}", "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Required. Name of the security report to get. Must be of the form `organizations/{org}/environments/{env}/securityReports/{reportId}`.", "pattern": "^organizations/[^/]+/environments/[^/]+/securityReports/[^/]+$" } }, "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\"", "httpMethod": "GET" }, "getResultView": { "httpMethod": "GET", "parameters": { "name": { "description": "Required. Name of the security report result view to get. Must be of the form `organizations/{org}/environments/{env}/securityReports/{reportId}/resultView`.", "pattern": "^organizations/[^/]+/environments/[^/]+/securityReports/[^/]+/resultView$", "location": "path", "type": "string", "required": true } }, "description": "After the query is completed, use this API to view the query result when result size is small.", "path": "v1/{+name}", "id": "apigee.organizations.environments.securityReports.getResultView", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityReports/{securityReportsId}/resultView", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1SecurityReportResultView" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "getResult": { "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Required. Name of the security report result to get. Must be of the form `organizations/{org}/environments/{env}/securityReports/{reportId}/result`.", "pattern": "^organizations/[^/]+/environments/[^/]+/securityReports/[^/]+/result$" } }, "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`", "httpMethod": "GET", "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityReports/{securityReportsId}/result", "id": "apigee.organizations.environments.securityReports.getResult", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleApiHttpBody" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } }, "sharedflows": { "resources": { "deployments": { "methods": { "list": { "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/sharedflows/{sharedflowsId}/deployments", "id": "apigee.organizations.environments.sharedflows.deployments.list", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ListDeploymentsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "required": true, "location": "path", "type": "string", "description": "Required. Name representing a shared flow in an environment in the following format: `organizations/{org}/environments/{env}/sharedflows/{sharedflow}` If the shared flow resource has the `space` attribute set, IAM permissions are checked differently . To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/environments/[^/]+/sharedflows/[^/]+$" } }, "description": "Lists all deployments of a shared flow in an environment.", "httpMethod": "GET", "path": "v1/{+parent}/deployments" } } }, "revisions": { "methods": { "deploy": { "response": { "$ref": "GoogleCloudApigeeV1Deployment" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.environments.sharedflows.revisions.deploy", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/sharedflows/{sharedflowsId}/revisions/{revisionsId}/deployments", "path": "v1/{+name}/deployments", "httpMethod": "POST", "parameters": { "serviceAccount": { "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`.", "location": "query", "type": "string" }, "name": { "required": true, "location": "path", "type": "string", "description": "Required. Name of the shared flow revision to deploy in the following format: `organizations/{org}/environments/{env}/sharedflows/{sharedflow}/revisions/{rev}` If the shared flow resource being deployed has the `space` attribute set, IAM permissions are checked differently . To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/environments/[^/]+/sharedflows/[^/]+/revisions/[^/]+$" }, "override": { "type": "boolean", "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.", "location": "query" } }, "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}`" }, "undeploy": { "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/sharedflows/{sharedflowsId}/revisions/{revisionsId}/deployments", "id": "apigee.organizations.environments.sharedflows.revisions.undeploy", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "Required. Name of the shared flow revision to undeploy in the following format: `organizations/{org}/environments/{env}/sharedflows/{sharedflow}/revisions/{rev}` If the shared flow resource has the `space` attribute set, IAM permissions are checked differently . To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/environments/[^/]+/sharedflows/[^/]+/revisions/[^/]+$", "type": "string", "location": "path", "required": true } }, "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}`", "httpMethod": "DELETE", "path": "v1/{+name}/deployments" }, "getDeployments": { "path": "v1/{+name}/deployments", "parameters": { "name": { "description": "Required. Name representing a shared flow in an environment in the following format: `organizations/{org}/environments/{env}/sharedflows/{sharedflow}/revisions/{rev}` If the shared flow resource has the `space` attribute set, IAM permissions are checked differently . To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/environments/[^/]+/sharedflows/[^/]+/revisions/[^/]+$", "required": true, "location": "path", "type": "string" } }, "description": "Gets the deployment of a shared flow revision and actual state reported by runtime pods.", "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/sharedflows/{sharedflowsId}/revisions/{revisionsId}/deployments", "id": "apigee.organizations.environments.sharedflows.revisions.getDeployments", "response": { "$ref": "GoogleCloudApigeeV1Deployment" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] } } } } }, "keyvaluemaps": { "methods": { "delete": { "path": "v1/{+name}", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. Name of the key value map. Use the following structure in your request: `organizations/{org}/environments/{env}/keyvaluemaps/{keyvaluemap}`", "pattern": "^organizations/[^/]+/environments/[^/]+/keyvaluemaps/[^/]+$" } }, "description": "Deletes a key value map from an environment.", "httpMethod": "DELETE", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keyvaluemaps/{keyvaluemapsId}", "id": "apigee.organizations.environments.keyvaluemaps.delete", "response": { "$ref": "GoogleCloudApigeeV1KeyValueMap" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "get": { "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keyvaluemaps/{keyvaluemapsId}", "id": "apigee.organizations.environments.keyvaluemaps.get", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1KeyValueMap" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "Required. Scope as indicated by the URI in which to fetch the key value map. 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}`. If the KeyValueMap is under an API Proxy resource that has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/environments/[^/]+/keyvaluemaps/[^/]+$", "required": true, "type": "string", "location": "path" } }, "description": "Get the key value map scoped to an organization, environment, or API proxy.", "httpMethod": "GET", "path": "v1/{+name}" }, "update": { "response": { "$ref": "GoogleCloudApigeeV1KeyValueMap" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.environments.keyvaluemaps.update", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keyvaluemaps/{keyvaluemapsId}", "request": { "$ref": "GoogleCloudApigeeV1KeyValueMap" }, "path": "v1/{+name}", "httpMethod": "PUT", "parameters": { "name": { "description": "Required. Scope as indicated by the URI in which to fetch the key value map. 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}`. If the KeyValueMap is under an API Proxy resource that has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/environments/[^/]+/keyvaluemaps/[^/]+$", "required": true, "type": "string", "location": "path" } }, "description": "Update the key value map scoped to an organization, environment, or API proxy." }, "create": { "id": "apigee.organizations.environments.keyvaluemaps.create", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keyvaluemaps", "response": { "$ref": "GoogleCloudApigeeV1KeyValueMap" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "path": "v1/{+parent}/keyvaluemaps", "httpMethod": "POST", "parameters": { "parent": { "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}`", "pattern": "^organizations/[^/]+/environments/[^/]+$", "type": "string", "location": "path", "required": true } }, "description": "Creates a key value map in an environment.", "request": { "$ref": "GoogleCloudApigeeV1KeyValueMap" } } }, "resources": { "entries": { "methods": { "get": { "response": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}", "id": "apigee.organizations.environments.keyvaluemaps.entries.get", "path": "v1/{+name}", "parameters": { "name": { "required": true, "location": "path", "type": "string", "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}`. If the KeyValueMap is under an API Proxy resource that has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/environments/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$" } }, "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.", "httpMethod": "GET" }, "update": { "request": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "path": "v1/{+name}", "httpMethod": "PUT", "parameters": { "name": { "type": "string", "location": "path", "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}`. If the KeyValueMap is under an API Proxy resource that has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/environments/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$" } }, "description": "Update key value entry scoped to an organization, environment, or API proxy for an existing key.", "response": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.environments.keyvaluemaps.entries.update", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}" }, "delete": { "path": "v1/{+name}", "parameters": { "name": { "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}`. If the KeyValueMap is under an API Proxy resource that has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/environments/[^/]+/keyvaluemaps/[^/]+/entries/[^/]+$", "type": "string", "location": "path", "required": true } }, "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.", "httpMethod": "DELETE", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keyvaluemaps/{keyvaluemapsId}/entries/{entriesId}", "id": "apigee.organizations.environments.keyvaluemaps.entries.delete", "response": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "create": { "path": "v1/{+parent}/entries", "parameters": { "parent": { "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}`. If the KeyValueMap is under an API Proxy resource that has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/environments/[^/]+/keyvaluemaps/[^/]+$", "required": true, "location": "path", "type": "string" } }, "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.", "httpMethod": "POST", "request": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keyvaluemaps/{keyvaluemapsId}/entries", "id": "apigee.organizations.environments.keyvaluemaps.entries.create", "response": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ] }, "list": { "path": "v1/{+parent}/entries", "httpMethod": "GET", "parameters": { "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" }, "pageToken": { "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.", "location": "query", "type": "string" }, "parent": { "location": "path", "type": "string", "required": true, "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}`. If the KeyValueMap is under an API Proxy resource that has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "pattern": "^organizations/[^/]+/environments/[^/]+/keyvaluemaps/[^/]+$" } }, "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.", "response": { "$ref": "GoogleCloudApigeeV1ListKeyValueEntriesResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "id": "apigee.organizations.environments.keyvaluemaps.entries.list", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/keyvaluemaps/{keyvaluemapsId}/entries" } } } } }, "resourcefiles": { "methods": { "create": { "parameters": { "name": { "type": "string", "description": "Required. Name of the resource file. Must match the regular expression: [a-zA-Z0-9:/\\\\!@#$%^&{}\\[\\]()+\\-=,.~'` ]{1,255}", "location": "query" }, "parent": { "description": "Required. Name of the environment in which to create the resource file in the following format: `organizations/{org}/environments/{env}`.", "pattern": "^organizations/[^/]+/environments/[^/]+$", "location": "path", "type": "string", "required": true }, "type": { "description": "Required. Resource file type. {{ resource_file_type }}", "location": "query", "type": "string" } }, "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).", "httpMethod": "POST", "path": "v1/{+parent}/resourcefiles", "request": { "$ref": "GoogleApiHttpBody" }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/resourcefiles", "id": "apigee.organizations.environments.resourcefiles.create", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ResourceFile" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "response": { "$ref": "GoogleCloudApigeeV1ListEnvironmentResourcesResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "id": "apigee.organizations.environments.resourcefiles.list", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/resourcefiles", "path": "v1/{+parent}/resourcefiles", "httpMethod": "GET", "parameters": { "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/[^/]+$" }, "type": { "type": "string", "description": "Optional. Type of resource files to list. {{ resource_file_type }}", "location": "query" } }, "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)." }, "listEnvironmentResources": { "path": "v1/{+parent}/resourcefiles/{type}", "httpMethod": "GET", "parameters": { "parent": { "description": "Required. Name of the environment in which to list resource files in the following format: `organizations/{org}/environments/{env}`.", "pattern": "^organizations/[^/]+/environments/[^/]+$", "type": "string", "location": "path", "required": true }, "type": { "description": "Optional. Type of resource files to list. {{ resource_file_type }}", "location": "path", "type": "string", "required": true } }, "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).", "response": { "$ref": "GoogleCloudApigeeV1ListEnvironmentResourcesResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent", "type" ], "id": "apigee.organizations.environments.resourcefiles.listEnvironmentResources", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/resourcefiles/{type}" }, "delete": { "parameterOrder": [ "parent", "type", "name" ], "response": { "$ref": "GoogleCloudApigeeV1ResourceFile" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/resourcefiles/{type}/{name}", "id": "apigee.organizations.environments.resourcefiles.delete", "parameters": { "name": { "type": "string", "description": "Required. ID of the resource file to delete. Must match the regular expression: [a-zA-Z0-9:/\\\\!@#$%^&{}\\[\\]()+\\-=,.~'` ]{1,255}", "location": "path", "required": true }, "parent": { "description": "Required. Name of the environment in the following format: `organizations/{org}/environments/{env}`.", "pattern": "^organizations/[^/]+/environments/[^/]+$", "required": true, "location": "path", "type": "string" }, "type": { "required": true, "description": "Required. Resource file type. {{ resource_file_type }}", "location": "path", "type": "string" } }, "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).", "httpMethod": "DELETE", "path": "v1/{+parent}/resourcefiles/{type}/{name}" }, "update": { "request": { "$ref": "GoogleApiHttpBody" }, "path": "v1/{+parent}/resourcefiles/{type}/{name}", "httpMethod": "PUT", "parameters": { "parent": { "description": "Required. Name of the environment in the following format: `organizations/{org}/environments/{env}`.", "pattern": "^organizations/[^/]+/environments/[^/]+$", "type": "string", "location": "path", "required": true }, "type": { "type": "string", "description": "Required. Resource file type. {{ resource_file_type }}", "location": "path", "required": true }, "name": { "type": "string", "description": "Required. ID of the resource file to update. Must match the regular expression: [a-zA-Z0-9:/\\\\!@#$%^&{}\\[\\]()+\\-=,.~'` ]{1,255}", "location": "path", "required": true } }, "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).", "response": { "$ref": "GoogleCloudApigeeV1ResourceFile" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent", "type", "name" ], "id": "apigee.organizations.environments.resourcefiles.update", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/resourcefiles/{type}/{name}" }, "get": { "path": "v1/{+parent}/resourcefiles/{type}/{name}", "httpMethod": "GET", "parameters": { "parent": { "description": "Required. Name of the environment in the following format: `organizations/{org}/environments/{env}`.", "pattern": "^organizations/[^/]+/environments/[^/]+$", "required": true, "type": "string", "location": "path" }, "type": { "description": "Required. Resource file type. {{ resource_file_type }}", "location": "path", "type": "string", "required": true }, "name": { "type": "string", "description": "Required. ID of the resource file. Must match the regular expression: [a-zA-Z0-9:/\\\\!@#$%^&{}\\[\\]()+\\-=,.~'` ]{1,255}", "location": "path", "required": true } }, "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", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/resourcefiles/{type}/{name}", "response": { "$ref": "GoogleApiHttpBody" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent", "type", "name" ] } } } }, "methods": { "getIamPolicy": { "parameters": { "resource": { "required": true, "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.", "pattern": "^organizations/[^/]+/environments/[^/]+$" }, "options.requestedPolicyVersion": { "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", "type": "integer", "format": "int32" } }, "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.", "httpMethod": "GET", "path": "v1/{+resource}:getIamPolicy", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}:getIamPolicy", "id": "apigee.organizations.environments.getIamPolicy", "parameterOrder": [ "resource" ], "response": { "$ref": "GoogleIamV1Policy" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "getTraceConfig": { "parameters": { "name": { "description": "Required. Name of the trace configuration. Use the following structure in your request: \"organizations/*/environments/*/traceConfig\".", "pattern": "^organizations/[^/]+/environments/[^/]+/traceConfig$", "location": "path", "type": "string", "required": true } }, "description": "Get distributed trace configuration in an environment.", "httpMethod": "GET", "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/traceConfig", "id": "apigee.organizations.environments.getTraceConfig", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1TraceConfig" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "updateSecurityActionsConfig": { "path": "v1/{+name}", "parameters": { "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`", "pattern": "^organizations/[^/]+/environments/[^/]+/securityActionsConfig$", "required": true, "type": "string", "location": "path" }, "updateMask": { "description": "The list of fields to update.", "location": "query", "type": "string", "format": "google-fieldmask" } }, "description": "UpdateSecurityActionConfig updates the current SecurityActions configuration. This method is used to enable/disable the feature at the environment level.", "httpMethod": "PATCH", "request": { "$ref": "GoogleCloudApigeeV1SecurityActionsConfig" }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityActionsConfig", "id": "apigee.organizations.environments.updateSecurityActionsConfig", "response": { "$ref": "GoogleCloudApigeeV1SecurityActionsConfig" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "setIamPolicy": { "id": "apigee.organizations.environments.setIamPolicy", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}:setIamPolicy", "response": { "$ref": "GoogleIamV1Policy" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "resource" ], "path": "v1/{+resource}:setIamPolicy", "httpMethod": "POST", "parameters": { "resource": { "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", "required": true } }, "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.", "request": { "$ref": "GoogleIamV1SetIamPolicyRequest" } }, "getDebugmask": { "id": "apigee.organizations.environments.getDebugmask", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/debugmask", "response": { "$ref": "GoogleCloudApigeeV1DebugMask" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "description": "Required. Name of the debug mask. Use the following structure in your request: `organizations/{org}/environments/{env}/debugmask`.", "pattern": "^organizations/[^/]+/environments/[^/]+/debugmask$", "type": "string", "location": "path", "required": true } }, "description": "Gets the debug mask singleton resource for an environment." }, "updateDebugmask": { "response": { "$ref": "GoogleCloudApigeeV1DebugMask" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.environments.updateDebugmask", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/debugmask", "request": { "$ref": "GoogleCloudApigeeV1DebugMask" }, "path": "v1/{+name}", "httpMethod": "PATCH", "parameters": { "name": { "description": "Name of the debug mask.", "pattern": "^organizations/[^/]+/environments/[^/]+/debugmask$", "type": "string", "location": "path", "required": true }, "replaceRepeatedFields": { "type": "boolean", "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).", "location": "query" }, "updateMask": { "type": "string", "description": "Field debug mask to support partial updates.", "location": "query", "format": "google-fieldmask" } }, "description": "Updates the debug mask singleton resource for an environment." }, "subscribe": { "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}:subscribe", "id": "apigee.organizations.environments.subscribe", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1Subscription" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "description": "Required. Name of the environment. Use the following structure in your request: `organizations/{org}/environments/{env}`", "pattern": "^organizations/[^/]+/environments/[^/]+$", "required": true, "type": "string", "location": "path" } }, "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.", "httpMethod": "POST", "path": "v1/{+parent}:subscribe" }, "unsubscribe": { "request": { "$ref": "GoogleCloudApigeeV1Subscription" }, "parameters": { "parent": { "description": "Required. Name of the environment. Use the following structure in your request: `organizations/{org}/environments/{env}`", "pattern": "^organizations/[^/]+/environments/[^/]+$", "location": "path", "type": "string", "required": true } }, "description": "Deletes a subscription for the environment's Pub/Sub topic.", "httpMethod": "POST", "path": "v1/{+parent}:unsubscribe", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}:unsubscribe", "id": "apigee.organizations.environments.unsubscribe" }, "modifyEnvironment": { "path": "v1/{+name}", "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Required. Name of the environment. Use the following structure in your request: `organizations/{org}/environments/{environment}`.", "pattern": "^organizations/[^/]+/environments/[^/]+$" }, "updateMask": { "format": "google-fieldmask", "type": "string", "description": "List of fields to be updated. Fields that can be updated: node_config.", "location": "query" } }, "description": "Updates properties for an Apigee environment with patch semantics using a field mask. **Note:** Not supported for Apigee hybrid.", "httpMethod": "PATCH", "request": { "$ref": "GoogleCloudApigeeV1Environment" }, "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}", "id": "apigee.organizations.environments.modifyEnvironment", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "get": { "path": "v1/{+name}", "parameters": { "name": { "description": "Required. Name of the environment. Use the following structure in your request: `organizations/{org}/environments/{env}`", "pattern": "^organizations/[^/]+/environments/[^/]+$", "location": "path", "type": "string", "required": true } }, "description": "Gets environment details.", "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}", "id": "apigee.organizations.environments.get", "response": { "$ref": "GoogleCloudApigeeV1Environment" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "getAddonsConfig": { "httpMethod": "GET", "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Required. Name of the add-ons config. Must be in the format of `/organizations/{org}/environments/{env}/addonsConfig`", "pattern": "^organizations/[^/]+/environments/[^/]+/addonsConfig$" } }, "description": "Gets the add-ons config of an environment.", "path": "v1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1AddonsConfig" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.environments.getAddonsConfig", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/addonsConfig" }, "getApiSecurityRuntimeConfig": { "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "required": true, "location": "path", "type": "string", "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$" } }, "description": "Gets the API Security runtime configuration for an environment. This named ApiSecurityRuntimeConfig to prevent conflicts with ApiSecurityConfig from addon config.", "id": "apigee.organizations.environments.getApiSecurityRuntimeConfig", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/apiSecurityRuntimeConfig", "response": { "$ref": "GoogleCloudApigeeV1ApiSecurityRuntimeConfig" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "updateTraceConfig": { "request": { "$ref": "GoogleCloudApigeeV1TraceConfig" }, "path": "v1/{+name}", "httpMethod": "PATCH", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. Name of the trace configuration. Use the following structure in your request: \"organizations/*/environments/*/traceConfig\".", "pattern": "^organizations/[^/]+/environments/[^/]+/traceConfig$" }, "updateMask": { "format": "google-fieldmask", "type": "string", "description": "List of fields to be updated.", "location": "query" } }, "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.", "response": { "$ref": "GoogleCloudApigeeV1TraceConfig" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.environments.updateTraceConfig", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/traceConfig" }, "delete": { "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Required. Name of the environment. Use the following structure in your request: `organizations/{org}/environments/{env}`", "pattern": "^organizations/[^/]+/environments/[^/]+$" } }, "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.", "httpMethod": "DELETE", "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}", "id": "apigee.organizations.environments.delete", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "update": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1Environment" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}", "id": "apigee.organizations.environments.update", "request": { "$ref": "GoogleCloudApigeeV1Environment" }, "parameters": { "name": { "description": "Required. Name of the environment. Use the following structure in your request: `organizations/{org}/environments/{env}`", "pattern": "^organizations/[^/]+/environments/[^/]+$", "required": true, "type": "string", "location": "path" } }, "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.", "httpMethod": "PUT", "path": "v1/{+name}" }, "getSecurityActionsConfig": { "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. The name of the SecurityActionsConfig to retrieve. This will always be: `organizations/{org}/environments/{env}/security_actions_config`", "pattern": "^organizations/[^/]+/environments/[^/]+/securityActionsConfig$" } }, "description": "GetSecurityActionConfig returns the current SecurityActions configuration.", "httpMethod": "GET", "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/securityActionsConfig", "id": "apigee.organizations.environments.getSecurityActionsConfig", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1SecurityActionsConfig" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "create": { "flatPath": "v1/organizations/{organizationsId}/environments", "id": "apigee.organizations.environments.create", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "path": "v1/{+parent}/environments", "parameters": { "parent": { "description": "Required. Name of the organization in which the environment will be created. Use the following structure in your request: `organizations/{org}`", "pattern": "^organizations/[^/]+$", "required": true, "type": "string", "location": "path" }, "name": { "type": "string", "description": "Optional. Name of the environment.", "location": "query" } }, "description": "Creates an environment in an organization.", "httpMethod": "POST", "request": { "$ref": "GoogleCloudApigeeV1Environment" } }, "updateEnvironment": { "httpMethod": "POST", "parameters": { "name": { "description": "Required. Name of the environment. Use the following structure in your request: `organizations/{org}/environments/{env}`", "pattern": "^organizations/[^/]+/environments/[^/]+$", "location": "path", "type": "string", "required": true } }, "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.", "path": "v1/{+name}", "request": { "$ref": "GoogleCloudApigeeV1Environment" }, "id": "apigee.organizations.environments.updateEnvironment", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1Environment" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "getDeployedConfig": { "response": { "$ref": "GoogleCloudApigeeV1EnvironmentConfig" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.environments.getDeployedConfig", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/deployedConfig", "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "location": "path", "type": "string", "required": true, "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$" } }, "description": "Gets the deployed configuration for an environment." }, "testIamPermissions": { "httpMethod": "POST", "parameters": { "resource": { "required": true, "location": "path", "type": "string", "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.", "pattern": "^organizations/[^/]+/environments/[^/]+$" } }, "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).", "path": "v1/{+resource}:testIamPermissions", "request": { "$ref": "GoogleIamV1TestIamPermissionsRequest" }, "id": "apigee.organizations.environments.testIamPermissions", "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}:testIamPermissions", "parameterOrder": [ "resource" ], "response": { "$ref": "GoogleIamV1TestIamPermissionsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } } }, "methods": { "getSyncAuthorization": { "request": { "$ref": "GoogleCloudApigeeV1GetSyncAuthorizationRequest" }, "path": "v1/{+name}:getSyncAuthorization", "httpMethod": "POST", "parameters": { "name": { "description": "Required. Name of the Apigee organization. Use the following structure in your request: `organizations/{org}`", "pattern": "^organizations/[^/]+$", "required": true, "location": "path", "type": "string" } }, "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.", "response": { "$ref": "GoogleCloudApigeeV1SyncAuthorization" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.getSyncAuthorization", "flatPath": "v1/organizations/{organizationsId}:getSyncAuthorization" }, "getProjectMapping": { "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. Apigee organization name in the following format: `organizations/{org}`", "pattern": "^organizations/[^/]+$" } }, "description": "Gets the project ID and region for an Apigee organization.", "httpMethod": "GET", "path": "v1/{+name}:getProjectMapping", "flatPath": "v1/organizations/{organizationsId}:getProjectMapping", "id": "apigee.organizations.getProjectMapping", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1OrganizationProjectMapping" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "getSecuritySettings": { "response": { "$ref": "GoogleCloudApigeeV1SecuritySettings" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.getSecuritySettings", "flatPath": "v1/organizations/{organizationsId}/securitySettings", "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "description": "Required. The name of the SecuritySettings to retrieve. This will always be: 'organizations/{org}/securitySettings'.", "pattern": "^organizations/[^/]+/securitySettings$", "required": true, "type": "string", "location": "path" } }, "description": "GetSecuritySettings gets the security settings for API Security." }, "updateControlPlaneAccess": { "request": { "$ref": "GoogleCloudApigeeV1ControlPlaneAccess" }, "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Identifier. The resource name of the ControlPlaneAccess. Format: \"organizations/{org}/controlPlaneAccess\"", "pattern": "^organizations/[^/]+/controlPlaneAccess$" }, "updateMask": { "description": "List of fields to be updated. Fields that can be updated: synchronizer_identities, publisher_identities.", "location": "query", "type": "string", "format": "google-fieldmask" } }, "description": "Updates the permissions required to allow Apigee runtime-plane components access to the control plane. Currently, the permissions required are to: 1. Allow runtime components to publish analytics data to the control plane. **Note**: Available to Apigee hybrid only.", "httpMethod": "PATCH", "path": "v1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/controlPlaneAccess", "id": "apigee.organizations.updateControlPlaneAccess" }, "get": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1Organization" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.get", "flatPath": "v1/organizations/{organizationsId}", "httpMethod": "GET", "parameters": { "name": { "description": "Required. Apigee organization name in the following format: `organizations/{org}`", "pattern": "^organizations/[^/]+$", "type": "string", "location": "path", "required": true } }, "description": "Gets the profile for an Apigee organization. See [Understanding organizations](https://cloud.google.com/apigee/docs/api-platform/fundamentals/organization-structure).", "path": "v1/{+name}" }, "getControlPlaneAccess": { "httpMethod": "GET", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. Resource name of the Control Plane Access. Use the following structure in your request: `organizations/{org}/controlPlaneAccess`", "pattern": "^organizations/[^/]+/controlPlaneAccess$" } }, "description": "Lists the service accounts allowed to access Apigee control plane directly for limited functionality. **Note**: Available to Apigee hybrid only.", "path": "v1/{+name}", "id": "apigee.organizations.getControlPlaneAccess", "flatPath": "v1/organizations/{organizationsId}/controlPlaneAccess", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1ControlPlaneAccess" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "setSyncAuthorization": { "id": "apigee.organizations.setSyncAuthorization", "flatPath": "v1/organizations/{organizationsId}:setSyncAuthorization", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1SyncAuthorization" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "name": { "description": "Required. Name of the Apigee organization. Use the following structure in your request: `organizations/{org}`", "pattern": "^organizations/[^/]+$", "required": true, "type": "string", "location": "path" } }, "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.", "path": "v1/{+name}:setSyncAuthorization", "request": { "$ref": "GoogleCloudApigeeV1SyncAuthorization" } }, "getDeployedIngressConfig": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1IngressConfig" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.getDeployedIngressConfig", "flatPath": "v1/organizations/{organizationsId}/deployedIngressConfig", "httpMethod": "GET", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. Name of the deployed configuration for the organization in the following format: 'organizations/{org}/deployedIngressConfig'.", "pattern": "^organizations/[^/]+/deployedIngressConfig$" }, "view": { "location": "query", "enum": [ "INGRESS_CONFIG_VIEW_UNSPECIFIED", "BASIC", "FULL" ], "type": "string", "description": "When set to FULL, additional details about the specific deployments receiving traffic will be included in the IngressConfig response's RoutingRules.", "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": "Gets the deployed ingress configuration for an organization.", "path": "v1/{+name}" }, "getRuntimeConfig": { "path": "v1/{+name}", "parameters": { "name": { "description": "Required. Name of the runtime config for the organization in the following format: 'organizations/{org}/runtimeConfig'.", "pattern": "^organizations/[^/]+/runtimeConfig$", "location": "path", "type": "string", "required": true } }, "description": "Get runtime config for an organization.", "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/runtimeConfig", "id": "apigee.organizations.getRuntimeConfig", "response": { "$ref": "GoogleCloudApigeeV1RuntimeConfig" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "list": { "parameters": { "parent": { "location": "path", "type": "string", "required": true, "description": "Required. Use the following structure in your request: `organizations`", "pattern": "^organizations$" } }, "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).", "httpMethod": "GET", "path": "v1/{+parent}", "flatPath": "v1/organizations", "id": "apigee.organizations.list", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudApigeeV1ListOrganizationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "create": { "httpMethod": "POST", "parameters": { "parent": { "type": "string", "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/`", "location": "query" } }, "description": "Creates an Apigee organization. See [Create an Apigee organization](https://cloud.google.com/apigee/docs/api-platform/get-started/create-org).", "path": "v1/organizations", "request": { "$ref": "GoogleCloudApigeeV1Organization" }, "id": "apigee.organizations.create", "flatPath": "v1/organizations", "parameterOrder": [], "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "setAddons": { "id": "apigee.organizations.setAddons", "flatPath": "v1/organizations/{organizationsId}:setAddons", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "org" ], "path": "v1/{+org}:setAddons", "httpMethod": "POST", "parameters": { "org": { "description": "Required. Name of the organization. Use the following structure in your request: `organizations/{org}`", "pattern": "^organizations/[^/]+$", "type": "string", "location": "path", "required": true } }, "description": "Configures the add-ons for the Apigee organization. The existing add-on configuration will be fully replaced.", "request": { "$ref": "GoogleCloudApigeeV1SetAddonsRequest" } }, "updateSecuritySettings": { "flatPath": "v1/organizations/{organizationsId}/securitySettings", "id": "apigee.organizations.updateSecuritySettings", "response": { "$ref": "GoogleCloudApigeeV1SecuritySettings" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1/{+name}", "parameters": { "name": { "location": "path", "type": "string", "required": true, "description": "Identifier. Full resource name is always `organizations/{org}/securitySettings`.", "pattern": "^organizations/[^/]+/securitySettings$" }, "updateMask": { "description": "Optional. The list of fields to update. Allowed fields are: - ml_retraining_feedback_enabled", "location": "query", "type": "string", "format": "google-fieldmask" } }, "description": "UpdateSecuritySettings updates the current security settings for API Security.", "httpMethod": "PATCH", "request": { "$ref": "GoogleCloudApigeeV1SecuritySettings" } }, "delete": { "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "apigee.organizations.delete", "flatPath": "v1/organizations/{organizationsId}", "path": "v1/{+name}", "httpMethod": "DELETE", "parameters": { "name": { "description": "Required. Name of the organization. Use the following structure in your request: `organizations/{org}`", "pattern": "^organizations/[^/]+$", "required": true, "type": "string", "location": "path" }, "retention": { "enumDescriptions": [ "Default data retention setting of seven days will be applied.", "Organization data will be retained for the minimum period of 24 hours." ], "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 Google Cloud project.**", "location": "query", "enum": [ "DELETION_RETENTION_UNSPECIFIED", "MINIMUM" ], "type": "string" } }, "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`.**" }, "update": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudApigeeV1Organization" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "apigee.organizations.update", "flatPath": "v1/organizations/{organizationsId}", "request": { "$ref": "GoogleCloudApigeeV1Organization" }, "httpMethod": "PUT", "parameters": { "name": { "description": "Required. Apigee organization name in the following format: `organizations/{org}`", "pattern": "^organizations/[^/]+$", "required": true, "type": "string", "location": "path" } }, "description": "Updates the properties for an Apigee organization. No other fields in the organization profile will be updated.", "path": "v1/{+name}" } } } }, "name": "apigee", "basePath": "", "endpoints": [ { "endpointUrl": "https://apigee.us.rep.googleapis.com/", "location": "us", "description": "Regional Endpoint" }, { "endpointUrl": "https://apigee.eu.rep.googleapis.com/", "location": "eu", "description": "Regional Endpoint" }, { "location": "in", "description": "Regional Endpoint", "endpointUrl": "https://apigee.in.rep.googleapis.com/" }, { "location": "sa", "description": "Regional Endpoint", "endpointUrl": "https://apigee.sa.rep.googleapis.com/" } ], "title": "Apigee API", "baseUrl": "https://apigee.googleapis.com/", "ownerDomain": "google.com", "schemas": { "GoogleCloudApigeeV1EnvironmentGroup": { "type": "object", "properties": { "hostnames": { "type": "array", "description": "Required. Host names for this environment group.", "items": { "type": "string" } }, "lastModifiedAt": { "readOnly": true, "format": "int64", "type": "string", "description": "Output only. The time at which the environment group was last updated as milliseconds since epoch." }, "state": { "description": "Output only. State of the environment group. 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." ], "type": "string", "enum": [ "STATE_UNSPECIFIED", "CREATING", "ACTIVE", "DELETING", "UPDATING" ], "readOnly": true }, "name": { "type": "string", "description": "ID of the environment group." }, "createdAt": { "description": "Output only. The time at which the environment group was created as milliseconds since epoch.", "type": "string", "readOnly": true, "format": "int64" } }, "description": "EnvironmentGroup configuration. An environment group is used to group one or more Apigee environments under a single host name.", "id": "GoogleCloudApigeeV1EnvironmentGroup" }, "GoogleCloudApigeeV1RuntimeAddonsConfig": { "type": "object", "properties": { "revisionId": { "description": "Revision number used by the runtime to detect config changes.", "type": "string" }, "analyticsConfig": { "description": "Runtime configuration for Analytics add-on.", "$ref": "GoogleCloudApigeeV1RuntimeAnalyticsConfig" }, "apiSecurityConfig": { "description": "Runtime configuration for API Security add-on.", "$ref": "GoogleCloudApigeeV1RuntimeApiSecurityConfig" }, "name": { "description": "Name of the addons config in the format: `organizations/{org}/environments/{env}/addonsConfig`", "type": "string" }, "uid": { "type": "string", "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." } }, "description": "RuntimeAddonsConfig defines the runtime configurations for add-ons in an environment.", "id": "GoogleCloudApigeeV1RuntimeAddonsConfig" }, "GoogleCloudApigeeV1ListAppGroupSubscriptionsResponse": { "id": "GoogleCloudApigeeV1ListAppGroupSubscriptionsResponse", "type": "object", "properties": { "appGroupSubscriptions": { "description": "The list of subscriptions for an AppGroup.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1AppGroupSubscription" } }, "nextPageToken": { "description": "Value that can be sent as `pageToken` to retrieve the next page of content. If this field is omitted, there are no subsequent pages.", "type": "string" } }, "description": "Response for ListAppGroupSubscriptions." }, "GoogleCloudApigeeV1TraceConfigOverride": { "id": "GoogleCloudApigeeV1TraceConfigOverride", "type": "object", "properties": { "name": { "description": "ID of the trace configuration override specified as a system-generated UUID.", "type": "string" }, "apiProxy": { "type": "string", "description": "ID of the API proxy that will have its trace configuration overridden." }, "samplingConfig": { "description": "Trace configuration to override.", "$ref": "GoogleCloudApigeeV1TraceSamplingConfig" } }, "description": "A representation of a configuration override." }, "GoogleCloudApigeeV1DeveloperBalanceWallet": { "description": "Wallet used to manage an account balance for a particular currency.", "type": "object", "properties": { "lastCreditTime": { "readOnly": true, "format": "int64", "type": "string", "description": "Output only. Time at which the developer last added credit to the account in milliseconds since epoch." }, "balance": { "description": "Current remaining balance of the developer for a particular currency.", "$ref": "GoogleTypeMoney" } }, "id": "GoogleCloudApigeeV1DeveloperBalanceWallet" }, "GoogleCloudApigeeV1ListDeploymentsResponse": { "type": "object", "properties": { "deployments": { "items": { "$ref": "GoogleCloudApigeeV1Deployment" }, "description": "List of deployments.", "type": "array" } }, "id": "GoogleCloudApigeeV1ListDeploymentsResponse" }, "GoogleCloudApigeeV1Quota": { "type": "object", "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": { "type": "string", "description": "Required. Upper limit allowed for the time interval and time unit specified. Requests exceeding this limit will be rejected." } }, "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.", "id": "GoogleCloudApigeeV1Quota" }, "GoogleCloudApigeeV1LlmOperationGroup": { "type": "object", "properties": { "operationConfigs": { "description": "Required. List of LLM operation configurations for either Apigee API proxies that are associated with this API product.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1LlmOperationConfig" } } }, "description": "List of LLM operation configuration details associated with Apigee API proxies.", "id": "GoogleCloudApigeeV1LlmOperationGroup" }, "GoogleCloudApigeeV1SecurityFeedbackFeedbackContext": { "id": "GoogleCloudApigeeV1SecurityFeedbackFeedbackContext", "description": "FeedbackContext captures the intent of the submitted feedback.", "type": "object", "properties": { "attribute": { "enumDescriptions": [ "Unspecified attribute.", "Values will be a list of environments.", "Values will be a list of IP addresses. This could be either IPv4 or IPv6." ], "description": "Required. The attribute the user is providing feedback about.", "enum": [ "ATTRIBUTE_UNSPECIFIED", "ATTRIBUTE_ENVIRONMENTS", "ATTRIBUTE_IP_ADDRESS_RANGES" ], "type": "string" }, "values": { "description": "Required. The values of the attribute the user is providing feedback about.", "type": "array", "items": { "type": "string" } } } }, "GoogleCloudApigeeV1ListApimServiceExtensionsResponse": { "type": "object", "properties": { "nextPageToken": { "description": "Page token that you can include in an `ListApimServiceExtensions` request to retrieve the next page. If omitted, no subsequent pages exist.", "type": "string" }, "apimServiceExtensions": { "items": { "$ref": "GoogleCloudApigeeV1ApimServiceExtension" }, "description": "service extension in a given organization.", "type": "array" } }, "description": "Response for list service extensions.", "id": "GoogleCloudApigeeV1ListApimServiceExtensionsResponse" }, "GoogleCloudApigeeV1CommonNameConfig": { "id": "GoogleCloudApigeeV1CommonNameConfig", "type": "object", "properties": { "name": { "type": "string" }, "matchWildCards": { "type": "boolean" } } }, "GoogleCloudApigeeV1MaintenanceUpdatePolicy": { "id": "GoogleCloudApigeeV1MaintenanceUpdatePolicy", "type": "object", "properties": { "maintenanceWindows": { "items": { "$ref": "GoogleCloudApigeeV1MaintenanceUpdatePolicyMaintenanceWindow" }, "description": "Optional. Preferred windows to perform maintenance. Currently limited to 1.", "type": "array" }, "maintenanceChannel": { "type": "string", "description": "Optional. Maintenance channel to specify relative scheduling for maintenance.", "enum": [ "MAINTENANCE_CHANNEL_UNSPECIFIED", "WEEK1", "WEEK2" ], "enumDescriptions": [ "Unspecified maintenance channel.", "Receive 1 weeks notice before maintenance occurs", "Receive 2 weeks notice before maintenance occurs" ] } }, "description": "MaintenanceUpdatePolicy specifies the preferred window to perform maintenance on the instance (day of the week and time of day)." }, "GoogleCloudApigeeV1SecurityReportQueryMetric": { "description": "Metric of the Query", "type": "object", "properties": { "aggregationFunction": { "description": "Aggregation function: avg, min, max, or sum.", "type": "string" }, "operator": { "type": "string", "description": "One of `+`, `-`, `/`, `%`, `*`." }, "alias": { "type": "string", "description": "Alias for the metric. Alias will be used to replace metric name in query results." }, "value": { "description": "Operand value should be provided when operator is set.", "type": "string" }, "name": { "description": "Required. Metric name.", "type": "string" } }, "id": "GoogleCloudApigeeV1SecurityReportQueryMetric" }, "GoogleCloudApigeeV1SecurityProfileV2ProfileAssessmentConfigApiHubGatewayTypeArray": { "description": "Message for the array of API Hub Gateway Types.", "type": "object", "properties": { "gatewayTypes": { "type": "array", "description": "Required. The array of API Hub Gateway Types.", "items": { "type": "string", "enum": [ "API_HUB_GATEWAY_TYPE_UNSPECIFIED", "APIGEE_X", "APIGEE_HYBRID", "APIGEE_EDGE", "APIGEE_OPDK" ], "enumDescriptions": [ "Gateway type is not specified.", "Gateway is Apigee X for API Hub.", "Gateway is Apigee Hybrid for API Hub.", "Gateway is Apigee Edge for API Hub.", "Gateway is Apigee OPDK for API Hub." ] } } }, "id": "GoogleCloudApigeeV1SecurityProfileV2ProfileAssessmentConfigApiHubGatewayTypeArray" }, "GoogleCloudApigeeV1InstanceDeploymentStatus": { "type": "object", "properties": { "deployedRevisions": { "description": "Revisions currently deployed in MPs.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1InstanceDeploymentStatusDeployedRevision" } }, "instance": { "description": "ID of the instance reporting the status.", "type": "string" }, "deployedRoutes": { "type": "array", "description": "Current routes deployed in the ingress routing table. A route which is missing will appear in `missing_routes`.", "items": { "$ref": "GoogleCloudApigeeV1InstanceDeploymentStatusDeployedRoute" } } }, "description": "The status of a deployment as reported by a single instance.", "id": "GoogleCloudApigeeV1InstanceDeploymentStatus" }, "GoogleCloudApigeeV1Deployment": { "description": "Deployment represents a deployment of an API proxy or shared flow.", "type": "object", "properties": { "instances": { "description": "Status reported by each runtime instance. **Note**: This field is displayed only when viewing deployment status.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1InstanceDeploymentStatus" } }, "routeConflicts": { "type": "array", "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" } }, "deployStartTime": { "format": "int64", "type": "string", "description": "Time the API proxy was marked `deployed` in the control plane in millisconds since epoch." }, "pods": { "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.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1PodStatus" } }, "proxyDeploymentType": { "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" ], "enum": [ "PROXY_DEPLOYMENT_TYPE_UNSPECIFIED", "STANDARD", "EXTENSIBLE" ], "type": "string", "readOnly": true }, "revision": { "description": "API proxy revision.", "type": "string" }, "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." ] }, "errors": { "items": { "$ref": "GoogleRpcStatus" }, "type": "array", "description": "Errors reported for this deployment. Populated only when state == ERROR. **Note**: This field is displayed only when viewing deployment status." }, "serviceAccount": { "description": "The full resource name of Cloud IAM Service Account that this deployment is using, eg, `projects/-/serviceAccounts/{email}`.", "type": "string" }, "apiProxy": { "type": "string", "description": "API proxy." } }, "id": "GoogleCloudApigeeV1Deployment" }, "GoogleCloudApigeeV1ApiDocDocumentation": { "id": "GoogleCloudApigeeV1ApiDocDocumentation", "type": "object", "properties": { "oasDocumentation": { "description": "Optional. OpenAPI Specification documentation.", "$ref": "GoogleCloudApigeeV1OASDocumentation" }, "asyncApiDocumentation": { "description": "Optional. AsyncAPI Specification documentation.", "$ref": "GoogleCloudApigeeV1AsyncApiDocumentation" }, "graphqlDocumentation": { "description": "Optional. GraphQL documentation.", "$ref": "GoogleCloudApigeeV1GraphqlDocumentation" } }, "description": "The documentation for a catalog item." }, "GoogleCloudApigeeV1DocumentationFile": { "type": "object", "properties": { "displayName": { "description": "Required. A display name for the file, shown in the management UI. Max length is 255 characters.", "type": "string" }, "contents": { "format": "byte", "type": "string", "description": "Required. The file contents. The max size is 4 MB." } }, "description": "Documentation file contents for a catalog item.", "id": "GoogleCloudApigeeV1DocumentationFile" }, "GoogleCloudApigeeV1DatastoreConfig": { "description": "Configuration detail for datastore", "type": "object", "properties": { "projectId": { "description": "Required. Google Cloud project in which the datastore exists", "type": "string" }, "datasetName": { "description": "BigQuery dataset name Required for `bigquery` target_type.", "type": "string" }, "tablePrefix": { "type": "string", "description": "Prefix of BigQuery table Required for `bigquery` target_type." }, "bucketName": { "type": "string", "description": "Name of the Cloud Storage bucket. Required for `gcs` target_type." }, "path": { "type": "string", "description": "Path of Cloud Storage bucket Required for `gcs` target_type." } }, "id": "GoogleCloudApigeeV1DatastoreConfig" }, "GoogleCloudApigeeV1AppGroupApp": { "description": "Response for [GetAppGroupApp].[AppGroupApps.GetAppGroupApp], [CreateAppGroupAppRequest].[AppGroupApp.CreateAppGroupAppRequest] and [DeleteAppGroupApp].[AppGroupApp.DeleteAppGroupApp]", "type": "object", "properties": { "apiProducts": { "type": "array", "description": "List of API products associated with the AppGroup app.", "items": { "type": "string" } }, "appGroup": { "type": "string", "description": "Immutable. Name of the parent AppGroup whose resource name format is of syntax (organizations/*/appgroups/*)." }, "attributes": { "items": { "$ref": "GoogleCloudApigeeV1Attribute" }, "description": "List of attributes for the AppGroup app.", "type": "array" }, "appId": { "description": "Immutable. ID of the AppGroup app.", "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", "type": "string", "description": "Output only. Time the AppGroup app was modified in milliseconds since epoch." }, "callbackUrl": { "type": "string", "description": "Callback URL used by OAuth 2.0 authorization servers to communicate authorization codes back to AppGroup apps." }, "createdAt": { "description": "Output only. Time the AppGroup app was created in milliseconds since epoch.", "type": "string", "readOnly": true, "format": "int64" }, "credentials": { "description": "Output only. Set of credentials for the AppGroup app consisting of the consumer key/secret pairs associated with the API products.", "type": "array", "readOnly": true, "items": { "$ref": "GoogleCloudApigeeV1Credential" } }, "scopes": { "items": { "type": "string" }, "type": "array", "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." }, "status": { "type": "string", "description": "Status of the App. Valid values include `approved` or `revoked`." }, "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.", "type": "string", "format": "int64" } }, "id": "GoogleCloudApigeeV1AppGroupApp" }, "GoogleCloudApigeeV1DeveloperSubscription": { "type": "object", "properties": { "name": { "readOnly": true, "type": "string", "description": "Output only. Name of the API product subscription." }, "apiproduct": { "description": "Name of the API product for which the developer is purchasing a subscription.", "type": "string" }, "startTime": { "format": "int64", "description": "Time when the API product subscription starts in milliseconds since epoch.", "type": "string" }, "endTime": { "format": "int64", "type": "string", "description": "Time when the API product subscription ends in milliseconds since epoch." }, "lastModifiedAt": { "type": "string", "description": "Output only. Time when the API product subscription was last modified in milliseconds since epoch.", "readOnly": true, "format": "int64" }, "createdAt": { "readOnly": true, "format": "int64", "type": "string", "description": "Output only. Time when the API product subscription was created in milliseconds since epoch." } }, "description": "Structure of a DeveloperSubscription.", "id": "GoogleCloudApigeeV1DeveloperSubscription" }, "GoogleCloudApigeeV1ProfileConfigMediation": { "description": "By default, following policies will be included: - OASValidation - SOAPMessageValidation", "type": "object", "properties": {}, "id": "GoogleCloudApigeeV1ProfileConfigMediation" }, "GoogleCloudApigeeV1Score": { "type": "object", "properties": { "timeRange": { "description": "Start and end time for the score.", "$ref": "GoogleTypeInterval" }, "subcomponents": { "items": { "$ref": "GoogleCloudApigeeV1ScoreComponent" }, "type": "array", "description": "List of all the drilldown score components." }, "component": { "description": "Component containing score, recommendations and actions.", "$ref": "GoogleCloudApigeeV1ScoreComponent" } }, "description": "Represents Security Score.", "id": "GoogleCloudApigeeV1Score" }, "GoogleCloudApigeeV1ReportProperty": { "id": "GoogleCloudApigeeV1ReportProperty", "type": "object", "properties": { "value": { "items": { "$ref": "GoogleCloudApigeeV1Attribute" }, "type": "array", "description": "property values" }, "property": { "description": "name of the property", "type": "string" } } }, "GoogleCloudApigeeV1ActivateNatAddressRequest": { "description": "Request for ActivateNatAddressRequest. Activate the nat address request.", "type": "object", "properties": {}, "id": "GoogleCloudApigeeV1ActivateNatAddressRequest" }, "GoogleCloudApigeeV1ExpireAppGroupSubscriptionRequest": { "id": "GoogleCloudApigeeV1ExpireAppGroupSubscriptionRequest", "description": "Request for ExpireAppGroupSubscription.", "type": "object", "properties": {} }, "GoogleCloudApigeeV1DebugMask": { "id": "GoogleCloudApigeeV1DebugMask", "type": "object", "properties": { "requestXPaths": { "description": "List of XPaths that specify the XML elements to be filtered from XML request message payloads.", "type": "array", "items": { "type": "string" } }, "faultJSONPaths": { "items": { "type": "string" }, "type": "array", "description": "List of JSON paths that specify the JSON elements to be filtered from JSON payloads in error flows." }, "name": { "type": "string", "description": "Name of the debug mask." }, "responseXPaths": { "items": { "type": "string" }, "type": "array", "description": "List of XPaths that specify the XML elements to be filtered from XML response message payloads." }, "responseJSONPaths": { "description": "List of JSON paths that specify the JSON elements to be filtered from JSON response message payloads.", "type": "array", "items": { "type": "string" } }, "faultXPaths": { "description": "List of XPaths that specify the XML elements to be filtered from XML payloads in error flows.", "type": "array", "items": { "type": "string" } }, "variables": { "type": "array", "description": "List of variables that should be masked from the debug output.", "items": { "type": "string" } }, "namespaces": { "type": "object", "description": "Map of namespaces to URIs.", "additionalProperties": { "type": "string" } }, "requestJSONPaths": { "items": { "type": "string" }, "type": "array", "description": "List of JSON paths that specify the JSON elements to be filtered from JSON request message payloads." } } }, "GoogleCloudApigeeV1TargetServerConfig": { "id": "GoogleCloudApigeeV1TargetServerConfig", "type": "object", "properties": { "tlsInfo": { "description": "TLS settings for the target server.", "$ref": "GoogleCloudApigeeV1TlsInfoConfig" }, "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", "description": "The protocol used by this target server.", "enum": [ "PROTOCOL_UNSPECIFIED", "HTTP", "HTTP2", "GRPC_TARGET", "GRPC", "EXTERNAL_CALLOUT" ] }, "enabled": { "description": "Whether the target server is enabled. An empty/omitted value for this field should be interpreted as true.", "type": "boolean" }, "name": { "type": "string", "description": "Target server revision name in the following format: `organizations/{org}/environments/{env}/targetservers/{targetserver}/revisions/{rev}`" }, "port": { "format": "int32", "type": "integer", "description": "Port number for the target server." }, "host": { "type": "string", "description": "Host name of the target server." } } }, "GoogleCloudApigeeV1Instance": { "type": "object", "properties": { "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" }, "lastModifiedAt": { "description": "Output only. Time the instance was last modified in milliseconds since epoch.", "type": "string", "readOnly": true, "format": "int64" }, "ipRange": { "type": "string", "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`" }, "scheduledMaintenance": { "description": "Output only. Time and date of the scheduled maintenance for this instance. This field is only populated for instances that have opted into Maintenance Window and if there is an upcoming maintenance. Cleared once the maintenance is complete.", "$ref": "GoogleCloudApigeeV1ScheduledMaintenance", "readOnly": true }, "host": { "readOnly": true, "type": "string", "description": "Output only. Internal hostname or IP address of the Apigee endpoint used by clients to connect to the service." }, "maintenanceUpdatePolicy": { "description": "Optional. Apigee customers can set the preferred window to perform maintenance on the instance (day of the week and time of day).", "$ref": "GoogleCloudApigeeV1MaintenanceUpdatePolicy" }, "diskEncryptionKeyName": { "type": "string", "description": "Optional. 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/([^/]+)`" }, "serviceAttachment": { "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", "readOnly": true }, "isVersionLocked": { "readOnly": true, "type": "boolean", "description": "Output only. Indicates whether the instance is version locked. If true, the instance will not be updated by automated runtime rollouts. This is only supported for Apigee X instances." }, "name": { "type": "string", "description": "Required. Resource ID of the instance. Values must match the regular expression `^a-z{0,30}[a-z\\d]$`." }, "displayName": { "type": "string", "description": "Optional. Display name for the instance." }, "state": { "description": "Output only. State of the instance. 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." ], "type": "string", "enum": [ "STATE_UNSPECIFIED", "CREATING", "ACTIVE", "DELETING", "UPDATING" ], "readOnly": true }, "createdAt": { "readOnly": true, "format": "int64", "description": "Output only. Time the instance was created in milliseconds since epoch.", "type": "string" }, "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 }, "consumerAcceptList": { "type": "array", "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.", "items": { "type": "string" } }, "description": { "description": "Optional. Description of the instance.", "type": "string" }, "peeringCidrRange": { "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`.", "deprecated": true, "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" ], "type": "string" }, "location": { "type": "string", "description": "Required. Compute Engine location where the instance resides." }, "port": { "type": "string", "description": "Output only. Port number of the exposed Apigee endpoint.", "readOnly": true } }, "description": "Apigee runtime instance.", "id": "GoogleCloudApigeeV1Instance" }, "GoogleTypeExpr": { "id": "GoogleTypeExpr", "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.", "type": "object", "properties": { "expression": { "type": "string", "description": "Textual representation of an expression in Common Expression Language syntax." }, "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" }, "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." } } }, "GoogleCloudApigeeV1InstanceDeploymentStatusDeployedRoute": { "type": "object", "properties": { "basepath": { "type": "string", "description": "Base path in the routing table." }, "environment": { "description": "Destination environment. This will be empty if the route is not yet reported.", "type": "string" }, "envgroup": { "type": "string", "description": "Environment group where this route is installed." }, "percentage": { "format": "int32", "type": "integer", "description": "Percentage of ingress replicas reporting this route." } }, "description": "Route deployed in the ingress routing table.", "id": "GoogleCloudApigeeV1InstanceDeploymentStatusDeployedRoute" }, "GoogleCloudApigeeV1ControlPlaneAccess": { "type": "object", "properties": { "synchronizerIdentities": { "items": { "type": "string" }, "type": "array", "description": "Optional. Array of service accounts to grant access to control plane resources (for the Synchronizer component). 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)." }, "name": { "description": "Identifier. The resource name of the ControlPlaneAccess. Format: \"organizations/{org}/controlPlaneAccess\"", "type": "string" }, "analyticsPublisherIdentities": { "items": { "type": "string" }, "type": "array", "description": "Optional. Array of service accounts authorized to publish analytics data to the control plane (for the Message Processor component)." } }, "description": "ControlPlaneAccess is the request body and response body of UpdateControlPlaneAccess. and the response body of GetControlPlaneAccess. The input identities contains an array of service accounts to grant access to the respective control plane resource, with each service account specified using the following format: `serviceAccount:`***service-account-name***. The ***service-account-name*** is formatted like an email address. For example: `my-control-plane-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.", "id": "GoogleCloudApigeeV1ControlPlaneAccess" }, "GoogleCloudApigeeV1ProvisionOrganizationRequest": { "type": "object", "properties": { "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`" }, "runtimeLocation": { "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.", "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. 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." }, "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" } }, "description": "Request for ProvisionOrganization.", "id": "GoogleCloudApigeeV1ProvisionOrganizationRequest" }, "GoogleCloudApigeeV1TraceConfig": { "type": "object", "properties": { "endpoint": { "description": "Required. Endpoint of the exporter.", "type": "string" }, "exporter": { "description": "Required. Exporter that is used to view the distributed trace captured using the chosen trace protocol. 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", "OPEN_TELEMETRY_COLLECTOR", "OPEN_TELEMETRY_CLOUD_TRACE" ], "type": "string", "enumDescriptions": [ "Exporter unspecified", "Exports events to Jaeger. Compatible with OpenCensus protocol.", "Exports events to Cloud Trace. Compatible with OpenCensus protocol.", "OpenTelemetry Collector. Compatible with OpenTelemetry protocol.", "Exports events to Cloud Trace. Compatible with OpenTelemetry protocol." ] }, "samplingConfig": { "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.", "$ref": "GoogleCloudApigeeV1TraceSamplingConfig" } }, "description": "TraceConfig defines the configurations in an environment of distributed trace.", "id": "GoogleCloudApigeeV1TraceConfig" }, "GoogleCloudApigeeV1RevenueShareRange": { "type": "object", "properties": { "sharePercentage": { "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.", "type": "number", "format": "double" }, "end": { "format": "int64", "description": "Ending value of the range. Set to 0 or `null` for the last range of values.", "type": "string" }, "start": { "format": "int64", "description": "Starting value of the range. Set to 0 or `null` for the initial range of values.", "type": "string" } }, "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.", "id": "GoogleCloudApigeeV1RevenueShareRange" }, "GoogleCloudApigeeV1ExportRequest": { "id": "GoogleCloudApigeeV1ExportRequest", "type": "object", "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`)." }, "datastoreName": { "description": "Required. Name of the preconfigured datastore.", "type": "string" }, "name": { "type": "string", "description": "Required. Display name of the export job." }, "dateRange": { "description": "Required. Date range of the data to export.", "$ref": "GoogleCloudApigeeV1DateRange" }, "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." }, "description": { "type": "string", "description": "Optional. Description of the export job." } }, "description": "Request body for [CreateExportRequest]" }, "GoogleCloudApigeeV1DeleteResponse": { "id": "GoogleCloudApigeeV1DeleteResponse", "description": "Response for certain delete operations.", "type": "object", "properties": { "gcpResource": { "type": "string", "description": "Google Cloud name of deleted resource." }, "status": { "type": "string", "description": "Status of the operation." }, "message": { "description": "Description of the operation.", "type": "string" }, "errorCode": { "description": "Unique error code for the request, if any.", "type": "string" }, "requestId": { "type": "string", "description": "Unique ID of the request." } } }, "GoogleCloudApigeeV1InstanceAttachment": { "type": "object", "properties": { "environment": { "type": "string", "description": "ID of the attached environment." }, "name": { "type": "string", "description": "Output only. ID of the attachment.", "readOnly": true }, "createdAt": { "readOnly": true, "format": "int64", "type": "string", "description": "Output only. Time the attachment was created in milliseconds since epoch." } }, "description": "InstanceAttachment represents the installation of an environment onto an instance.", "id": "GoogleCloudApigeeV1InstanceAttachment" }, "GoogleCloudApigeeV1DeploymentChangeReportRoutingChange": { "description": "Describes a potential routing change that may occur as a result of some deployment operation.", "type": "object", "properties": { "environmentGroup": { "type": "string", "description": "Name of the environment group affected by this routing change." }, "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." }, "description": { "description": "Human-readable description of this routing change.", "type": "string" }, "fromDeployment": { "description": "Base path/deployment that may stop receiving some traffic.", "$ref": "GoogleCloudApigeeV1DeploymentChangeReportRoutingDeployment" }, "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" } }, "id": "GoogleCloudApigeeV1DeploymentChangeReportRoutingChange" }, "GoogleCloudApigeeV1DeploymentGroupConfig": { "type": "object", "properties": { "uid": { "type": "string", "description": "Unique ID. The ID will only change if the deployment group is deleted and recreated." }, "name": { "type": "string", "description": "Name of the deployment group in the following format: `organizations/{org}/environments/{env}/deploymentGroups/{group}`." }, "deploymentGroupType": { "enumDescriptions": [ "Unspecified type", "Standard type", "Extensible Type" ], "type": "string", "description": "Type of the deployment group, which will be either Standard or Extensible.", "enum": [ "DEPLOYMENT_GROUP_TYPE_UNSPECIFIED", "STANDARD", "EXTENSIBLE" ] }, "revisionId": { "format": "int64", "type": "string", "description": "Revision number which can be used by the runtime to detect if the deployment group has changed between two versions." } }, "description": "DeploymentGroupConfig represents a deployment group that should be present in a particular environment.", "id": "GoogleCloudApigeeV1DeploymentGroupConfig" }, "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." } }, "id": "GoogleCloudApigeeV1TlsInfoCommonName" }, "GoogleCloudApigeeV1CreditDeveloperBalanceRequest": { "id": "GoogleCloudApigeeV1CreditDeveloperBalanceRequest", "description": "Request for CreditDeveloperBalance.", "type": "object", "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" } } }, "GoogleCloudApigeeV1UpdateAppGroupAppKeyRequest": { "description": "Request for UpdateAppGroupAppKey", "type": "object", "properties": { "appGroupAppKey": { "description": "Note that only Scopes and Attributes of the AppGroupAppKey can be amended. Scopes and Attributes mentioned in the request will be inserted and the existing scopes and attributes will be removed.", "$ref": "GoogleCloudApigeeV1AppGroupAppKey" }, "action": { "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.", "type": "string" }, "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" } } }, "id": "GoogleCloudApigeeV1UpdateAppGroupAppKeyRequest" }, "GoogleCloudApigeeV1ProfileConfig": { "description": "ProfileConfig defines a set of categories and policies which will be used to compute security score.", "type": "object", "properties": { "categories": { "items": { "$ref": "GoogleCloudApigeeV1ProfileConfigCategory" }, "type": "array", "description": "List of categories of profile config." } }, "id": "GoogleCloudApigeeV1ProfileConfig" }, "GoogleCloudApigeeV1AsyncApiDocumentation": { "description": "AsyncAPI Specification documentation for a catalog item.", "type": "object", "properties": { "spec": { "description": "Required. The documentation file contents for the AsyncAPI Specification. JSON and YAML file formats are supported.", "$ref": "GoogleCloudApigeeV1DocumentationFile" } }, "id": "GoogleCloudApigeeV1AsyncApiDocumentation" }, "GoogleCloudApigeeV1NatAddress": { "type": "object", "properties": { "name": { "description": "Required. Resource ID of the NAT address.", "type": "string" }, "ipAddress": { "readOnly": true, "description": "Output only. The static IPV4 address.", "type": "string" }, "state": { "description": "Output only. State of the nat address.", "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." ], "type": "string", "enum": [ "STATE_UNSPECIFIED", "CREATING", "RESERVED", "ACTIVE", "DELETING" ], "readOnly": true } }, "description": "Apigee NAT(network address translation) address. A NAT address is a static external IP address used for Internet egress traffic.", "id": "GoogleCloudApigeeV1NatAddress" }, "GoogleCloudApigeeV1Reference": { "type": "object", "properties": { "description": { "type": "string", "description": "Optional. A human-readable description of this reference." }, "name": { "type": "string", "description": "Required. The resource id of this reference. Values must match the regular expression [\\w\\s\\-.]+." }, "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" } }, "description": "A Reference configuration. References must refer to a keystore that also exists in the parent environment.", "id": "GoogleCloudApigeeV1Reference" }, "GoogleCloudApigeeV1ComputeEnvironmentScoresResponse": { "description": "Response for ComputeEnvironmentScores.", "type": "object", "properties": { "scores": { "description": "List of scores. One score per day.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1Score" } }, "nextPageToken": { "description": "A page token, received from a previous `ComputeScore` call. Provide this to retrieve the subsequent page.", "type": "string" } }, "id": "GoogleCloudApigeeV1ComputeEnvironmentScoresResponse" }, "GoogleCloudApigeeV1SecurityActionFlag": { "id": "GoogleCloudApigeeV1SecurityActionFlag", "description": "The message that should be set in the case of a Flag action.", "type": "object", "properties": { "headers": { "items": { "$ref": "GoogleCloudApigeeV1SecurityActionHttpHeader" }, "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.", "type": "array" } } }, "GoogleCloudApigeeV1ListSecurityActionsResponse": { "type": "object", "properties": { "securityActions": { "description": "The SecurityActions for the specified environment.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1SecurityAction" } }, "nextPageToken": { "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.", "type": "string" } }, "description": "Contains a list of SecurityActions in response to a ListSecurityActionRequest.", "id": "GoogleCloudApigeeV1ListSecurityActionsResponse" }, "GoogleCloudApigeeV1Attribute": { "id": "GoogleCloudApigeeV1Attribute", "type": "object", "properties": { "name": { "description": "API key of the attribute.", "type": "string" }, "value": { "description": "Value of the attribute.", "type": "string" } }, "description": "Key-value pair to store extra metadata." }, "GoogleCloudApigeeV1EnvironmentClientIPResolutionConfigHeaderIndexAlgorithm": { "id": "GoogleCloudApigeeV1EnvironmentClientIPResolutionConfigHeaderIndexAlgorithm", "type": "object", "properties": { "ipHeaderIndex": { "description": "Required. The index of the ip in the header. Positive indices 0, 1, 2, 3 chooses indices from the left (first ips) Negative indices -1, -2, -3 chooses indices from the right (last ips)", "type": "integer", "format": "int32" }, "ipHeaderName": { "description": "Required. The name of the header to extract the client ip from.", "type": "string" } }, "description": "Resolves the client ip based on a custom header." }, "GoogleCloudApigeeV1SetAddonEnablementRequest": { "type": "object", "properties": { "analyticsEnabled": { "type": "boolean", "description": "If the Analytics should be enabled in the environment." }, "apiSecurityEnabled": { "type": "boolean", "description": "If the API Security should be enabled in the environment." } }, "description": "Request for SetAddonEnablement.", "id": "GoogleCloudApigeeV1SetAddonEnablementRequest" }, "GoogleCloudApigeeV1ServiceIssuersMapping": { "id": "GoogleCloudApigeeV1ServiceIssuersMapping", "type": "object", "properties": { "emailIds": { "items": { "type": "string" }, "description": "List of trusted issuer email ids.", "type": "array" }, "service": { "type": "string", "description": "String indicating the Apigee service name." } } }, "GoogleCloudApigeeV1DisableSecurityActionRequest": { "description": "Message to disable an enabled SecurityAction.", "type": "object", "properties": {}, "id": "GoogleCloudApigeeV1DisableSecurityActionRequest" }, "GoogleRpcPreconditionFailureViolation": { "type": "object", "properties": { "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\"." }, "subject": { "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.", "type": "string" }, "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\"." } }, "description": "A message type used to describe a single precondition failure.", "id": "GoogleRpcPreconditionFailureViolation" }, "GoogleCloudApigeeV1SecurityAssessmentResultScoringResultAssessmentRecommendationRecommendationLink": { "description": "The format for a link in the recommendation.", "type": "object", "properties": { "text": { "type": "string", "description": "The text of the url. (ie: \"Learn more\")" }, "uri": { "type": "string", "description": "The link itself." } }, "id": "GoogleCloudApigeeV1SecurityAssessmentResultScoringResultAssessmentRecommendationRecommendationLink" }, "GoogleCloudApigeeV1OASDocumentation": { "type": "object", "properties": { "spec": { "description": "Required. The documentation file contents for the OpenAPI Specification. JSON and YAML file formats are supported.", "$ref": "GoogleCloudApigeeV1DocumentationFile" }, "format": { "type": "string", "enum": [ "FORMAT_UNSPECIFIED", "YAML", "JSON" ], "readOnly": true, "description": "Output only. The format of the input specification file contents.", "enumDescriptions": [ "The format is not available.", "YAML format.", "JSON format." ] } }, "description": "OpenAPI Specification documentation for a catalog item.", "id": "GoogleCloudApigeeV1OASDocumentation" }, "GoogleCloudApigeeV1AccessSet": { "type": "object", "properties": { "value": { "type": "string" }, "success": { "type": "boolean" }, "name": { "type": "string" } }, "description": "Set action. For example, \"Set\" : { \"name\" : \"target.name\", \"success\" : true, \"value\" : \"default\" }", "id": "GoogleCloudApigeeV1AccessSet" }, "GoogleCloudApigeeV1DeploymentChangeReportRoutingConflict": { "type": "object", "properties": { "environmentGroup": { "type": "string", "description": "Name of the environment group in which this conflict exists." }, "conflictingDeployment": { "description": "Existing base path/deployment causing the conflict.", "$ref": "GoogleCloudApigeeV1DeploymentChangeReportRoutingDeployment" }, "description": { "description": "Human-readable description of this conflict.", "type": "string" } }, "description": "Describes a routing conflict that may cause a deployment not to receive traffic at some base path.", "id": "GoogleCloudApigeeV1DeploymentChangeReportRoutingConflict" }, "GoogleApiHttpBody": { "id": "GoogleApiHttpBody", "type": "object", "properties": { "contentType": { "description": "The HTTP Content-Type header value specifying the content type of the body.", "type": "string" }, "data": { "type": "string", "description": "The HTTP request/response body as raw binary.", "format": "byte" }, "extensions": { "items": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." } }, "description": "Application specific response metadata. Must be set in the first response for streaming APIs.", "type": "array" } }, "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." }, "GoogleCloudApigeeV1TestDatastoreResponse": { "description": "The response for TestDatastore", "type": "object", "properties": { "state": { "readOnly": true, "type": "string", "description": "Output only. It could be `completed` or `failed`" }, "error": { "description": "Output only. Error message of test connection failure", "type": "string", "readOnly": true } }, "id": "GoogleCloudApigeeV1TestDatastoreResponse" }, "GoogleCloudApigeeV1SharedFlowRevision": { "id": "GoogleCloudApigeeV1SharedFlowRevision", "type": "object", "properties": { "createdAt": { "format": "int64", "description": "Time at which this shared flow revision was created, in milliseconds since epoch.", "type": "string" }, "entityMetaDataAsProperties": { "description": "A Key-Value map of metadata about this shared flow revision.", "additionalProperties": { "type": "string" }, "type": "object" }, "revision": { "description": "The resource ID of this revision.", "type": "string" }, "configurationVersion": { "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.", "$ref": "GoogleCloudApigeeV1ConfigVersion" }, "name": { "description": "The resource ID of the parent shared flow.", "type": "string" }, "resources": { "items": { "type": "string" }, "description": "A list of the resources included in this shared flow revision formatted as \"{type}://{name}\".", "type": "array" }, "displayName": { "type": "string", "description": "The human readable name of this shared flow." }, "description": { "description": "Description of the shared flow revision.", "type": "string" }, "lastModifiedAt": { "description": "Time at which this shared flow revision was most recently modified, in milliseconds since epoch.", "type": "string", "format": "int64" }, "resourceFiles": { "description": "The resource files included in this shared flow revision.", "$ref": "GoogleCloudApigeeV1ResourceFiles" }, "sharedFlows": { "items": { "type": "string" }, "description": "A list of the shared flow names included in this shared flow revision.", "type": "array" }, "type": { "description": "The string \"Application\"", "type": "string" }, "policies": { "items": { "type": "string" }, "description": "A list of policy names included in this shared flow revision.", "type": "array" }, "contextInfo": { "type": "string", "description": "A textual description of the shared flow revision." } }, "description": "The metadata describing a shared flow revision." }, "GoogleCloudApigeeV1SecurityActionsConfig": { "id": "GoogleCloudApigeeV1SecurityActionsConfig", "type": "object", "properties": { "enabled": { "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.", "type": "boolean" }, "name": { "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`" }, "updateTime": { "readOnly": true, "format": "google-datetime", "type": "string", "description": "Output only. The update time for configuration." } }, "description": "SecurityActionsConfig reflects the current state of the SecurityActions feature. This is a singleton resource: https://google.aip.dev/156" }, "GoogleCloudApigeeV1SchemaSchemaElement": { "id": "GoogleCloudApigeeV1SchemaSchemaElement", "type": "object", "properties": { "name": { "type": "string", "description": "Name of the field." }, "properties": { "description": "Properties for the schema field. For example: { \"createTime\": \"2016-02-26T10:23:09.592Z\", \"custom\": \"false\", \"type\": \"string\" }", "$ref": "GoogleCloudApigeeV1SchemaSchemaProperty" } }, "description": "Message type for the schema element" }, "GoogleCloudApigeeV1ApiDocResponse": { "description": "The catalog item resource wrapped with response status, error_code, etc.", "type": "object", "properties": { "data": { "description": "The catalog item resource.", "$ref": "GoogleCloudApigeeV1ApiDoc" }, "status": { "type": "string", "description": "Status of the operation." }, "message": { "description": "Description of the operation.", "type": "string" }, "errorCode": { "description": "Unique error code for the request, if any.", "type": "string" }, "requestId": { "description": "Unique ID of the request.", "type": "string" } }, "id": "GoogleCloudApigeeV1ApiDocResponse" }, "GoogleCloudApigeeV1Session": { "type": "object", "properties": { "timestampMs": { "format": "int64", "type": "string", "description": "The first transaction creation timestamp in millisecond, recorded by UAP." }, "id": { "description": "The debug session ID.", "type": "string" } }, "description": "Session carries the debug session id and its creation time.", "id": "GoogleCloudApigeeV1Session" }, "GoogleCloudApigeeV1DeveloperBalance": { "type": "object", "properties": { "wallets": { "type": "array", "description": "Output only. List of all wallets. Each individual wallet stores the account balance for a particular currency.", "readOnly": true, "items": { "$ref": "GoogleCloudApigeeV1DeveloperBalanceWallet" } } }, "description": "Account balance for the developer.", "id": "GoogleCloudApigeeV1DeveloperBalance" }, "GoogleIamV1Policy": { "id": "GoogleIamV1Policy", "type": "object", "properties": { "etag": { "type": "string", "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.", "format": "byte" }, "version": { "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).", "type": "integer", "format": "int32" }, "bindings": { "type": "array", "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`.", "items": { "$ref": "GoogleIamV1Binding" } }, "auditConfigs": { "items": { "$ref": "GoogleIamV1AuditConfig" }, "type": "array", "description": "Specifies cloud audit logging configuration for this policy." } }, "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/)." }, "GoogleCloudApigeeV1EndpointAttachment": { "type": "object", "properties": { "name": { "description": "Name of the endpoint attachment. Use the following structure in your request: `organizations/{org}/endpointAttachments/{endpoint_attachment}`", "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." ], "description": "Output only. State of the endpoint attachment. Values other than `ACTIVE` mean the resource is not ready to use.", "readOnly": true, "type": "string", "enum": [ "STATE_UNSPECIFIED", "CREATING", "ACTIVE", "DELETING", "UPDATING" ] }, "serviceAttachment": { "type": "string", "description": "Format: projects/*/regions/*/serviceAttachments/*" }, "connectionState": { "readOnly": true, "enum": [ "CONNECTION_STATE_UNSPECIFIED", "UNAVAILABLE", "PENDING", "ACCEPTED", "REJECTED", "CLOSED", "FROZEN", "NEEDS_ATTENTION", "ACCEPTED_LIMITED_CAPACITY" ], "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.", "The connection has been accepted by the PSC producer, but it will only serve capacity limited traffic. The producer needs to take further actions to increase capacity for this connection." ], "description": "Output only. State of the endpoint attachment connection to the service attachment." }, "host": { "readOnly": true, "type": "string", "description": "Output only. Host that can be used in either the HTTP target endpoint directly or as the host in target server." }, "location": { "description": "Required. Location of the endpoint attachment.", "type": "string" } }, "description": "Apigee endpoint attachment. For more information, see [Southbound networking patterns] (https://cloud.google.com/apigee/docs/api-platform/architecture/southbound-networking-patterns-endpoints).", "id": "GoogleCloudApigeeV1EndpointAttachment" }, "GoogleCloudApigeeV1RatePlan": { "id": "GoogleCloudApigeeV1RatePlan", "description": "Rate plan details.", "type": "object", "properties": { "paymentFundingModel": { "enum": [ "PAYMENT_FUNDING_MODEL_UNSPECIFIED", "PREPAID", "POSTPAID" ], "type": "string", "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." ], "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." }, "billingPeriod": { "enumDescriptions": [ "Billing period not specified.", "Weekly billing period. **Note**: Not supported by Apigee at this time.", "Monthly billing period." ], "description": "Frequency at which the customer will be billed.", "enum": [ "BILLING_PERIOD_UNSPECIFIED", "WEEKLY", "MONTHLY" ], "type": "string" }, "setupFee": { "description": "Initial, one-time fee paid when purchasing the API product.", "$ref": "GoogleTypeMoney" }, "fixedFeeFrequency": { "format": "int32", "description": "Frequency at which the fixed fee is charged.", "type": "integer" }, "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" }, "lastModifiedAt": { "readOnly": true, "format": "int64", "type": "string", "description": "Output only. Time the rate plan was last modified in milliseconds since epoch." }, "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." ], "description": "Method used to calculate the revenue that is shared with developers.", "enum": [ "REVENUE_SHARE_TYPE_UNSPECIFIED", "FIXED", "VOLUME_BANDED" ], "type": "string" }, "startTime": { "type": "string", "description": "Time when the rate plan becomes active in milliseconds since epoch.", "format": "int64" }, "endTime": { "type": "string", "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.", "format": "int64" }, "revenueShareRates": { "description": "Details of the revenue sharing model.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1RevenueShareRange" } }, "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 `BANDED` and the ranges are defined as follows: ``` { \"start\": 1, \"end\": 100, \"fee\": 2 }, { \"start\": 101, \"end\": 200, \"fee\": 1.50 }, { \"start\": 201, \"end\": 0, \"fee\": 1 }, } ``` Then the following fees would be charged based on the total number of API calls (assuming the currency selected is `USD`): * 50 calls cost 50 x $2 = $100 * 150 calls cost 100 x $2 + 50 x $1.5 = $275 * 250 calls cost 100 x $2 + 100 x $1.5 + 50 x $1 = $400 * 500 calls cost 100 x $2 + 100 x $1.5 + 300 x $1 = $650", "items": { "$ref": "GoogleCloudApigeeV1RateRange" } }, "name": { "type": "string", "description": "Output only. Name of the rate plan.", "readOnly": true }, "displayName": { "type": "string", "description": "Display name of the rate plan." }, "state": { "description": "Current state of the rate plan (draft or published).", "enum": [ "STATE_UNSPECIFIED", "DRAFT", "PUBLISHED" ], "type": "string", "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`)." ] }, "consumptionPricingType": { "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." ], "type": "string", "description": "Pricing model used for consumption-based charges.", "enum": [ "CONSUMPTION_PRICING_TYPE_UNSPECIFIED", "FIXED_PER_UNIT", "BANDED", "TIERED", "STAIRSTEP" ] }, "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" }, "description": { "type": "string", "description": "Description of the rate plan." }, "apiproduct": { "type": "string", "description": "Name of the API product that the rate plan is associated with." } } }, "GoogleCloudApigeeV1Access": { "type": "object", "properties": { "Remove": { "$ref": "GoogleCloudApigeeV1AccessRemove" }, "Get": { "$ref": "GoogleCloudApigeeV1AccessGet" }, "Set": { "$ref": "GoogleCloudApigeeV1AccessSet" } }, "id": "GoogleCloudApigeeV1Access" }, "GoogleCloudApigeeV1MoveApiProxyRequest": { "id": "GoogleCloudApigeeV1MoveApiProxyRequest", "description": "Moves an API Proxy to a different Space.", "type": "object", "properties": { "space": { "type": "string", "description": "Optional. Resource ID of the space to move the proxy to. If unspecified, the proxy will be moved to the organization level." } } }, "GoogleCloudApigeeV1SecurityAssessmentResultScoringResultAssessmentRecommendationRecommendation": { "id": "GoogleCloudApigeeV1SecurityAssessmentResultScoringResultAssessmentRecommendationRecommendation", "type": "object", "properties": { "description": { "description": "The description of the recommendation.", "type": "string" }, "link": { "description": "The link for the recommendation.", "$ref": "GoogleCloudApigeeV1SecurityAssessmentResultScoringResultAssessmentRecommendationRecommendationLink" } }, "description": "The format of the assessment recommendation." }, "GoogleIamV1Binding": { "type": "object", "properties": { "role": { "type": "string", "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)." }, "members": { "items": { "type": "string" }, "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`.", "type": "array" }, "condition": { "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).", "$ref": "GoogleTypeExpr" } }, "description": "Associates `members`, or principals, with a `role`.", "id": "GoogleIamV1Binding" }, "GoogleCloudApigeeV1QueryMetric": { "type": "object", "properties": { "alias": { "description": "Alias for the metric. Alias will be used to replace metric name in query results.", "type": "string" }, "operator": { "description": "One of `+`, `-`, `/`, `%`, `*`.", "type": "string" }, "name": { "description": "Required. Metric name.", "type": "string" }, "value": { "description": "Operand value should be provided when operator is set.", "type": "string" }, "function": { "type": "string", "description": "Aggregation function: avg, min, max, or sum." } }, "description": "More info about Metric: https://docs.apigee.com/api-platform/analytics/analytics-reference#metrics", "id": "GoogleCloudApigeeV1QueryMetric" }, "GoogleProtobufEmpty": { "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); }", "type": "object", "properties": {}, "id": "GoogleProtobufEmpty" }, "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.", "type": "object", "properties": { "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" }, "type": "array", "description": "Optional. A list of API keys. Limit 1000 per action." }, "accessTokens": { "items": { "type": "string" }, "type": "array", "description": "Optional. A list of access_tokens. Limit 1000 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" }, "developerApps": { "items": { "type": "string" }, "description": "Optional. A list of developer apps. Limit 1000 per action.", "type": "array" }, "asns": { "type": "array", "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.", "items": { "type": "string", "format": "int64" } }, "developers": { "items": { "type": "string" }, "type": "array", "description": "Optional. A list of developers. Limit 1000 per action." }, "ipAddressRanges": { "items": { "type": "string" }, "type": "array", "description": "Optional. A list of IP addresses. This could be either IPv4 or IPv6. Limited to 100 per action." }, "userAgents": { "items": { "type": "string" }, "type": "array", "description": "Optional. A list of user agents to deny. We look for exact matches. Limit 50 per action." }, "botReasons": { "items": { "type": "string" }, "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.", "type": "array" }, "apiProducts": { "type": "array", "description": "Optional. A list of API Products. Limit 1000 per action.", "items": { "type": "string" } } }, "id": "GoogleCloudApigeeV1SecurityActionConditionConfig" }, "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestResourceArray": { "id": "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestResourceArray", "description": "Message for the array of resources. For Apigee, the proxies are resources.", "type": "object", "properties": { "resources": { "description": "Required. The array of resources. For Apigee, the proxies are resources.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestResourceArrayResource" } } } }, "GoogleCloudApigeeV1SecurityMonitoringCondition": { "id": "GoogleCloudApigeeV1SecurityMonitoringCondition", "description": "Security monitoring condition for risk assessment version 2.", "type": "object", "properties": { "riskAssessmentType": { "type": "string", "description": "Optional. The risk assessment type of the security monitoring condition. Defaults to ADVANCED_API_SECURITY.", "enum": [ "RISK_ASSESSMENT_TYPE_UNSPECIFIED", "APIGEE", "API_HUB" ], "enumDescriptions": [ "Risk assessment type is not specified.", "Risk assessment type is Apigee.", "Risk assessment type is API Hub." ] }, "updateTime": { "type": "string", "description": "Output only. The time of the security monitoring condition update.", "readOnly": true, "format": "google-datetime" }, "scope": { "type": "string", "description": "Optional. Scope of the security monitoring condition. When RiskAssessmentType is APIGEE, the scope should be set to the environment of the resources. When RiskAssessmentType is API_HUB, the scope should not be set." }, "totalMonitoredResources": { "type": "integer", "description": "Output only. Total number of monitored resources within this condition.", "readOnly": true, "format": "int32" }, "profile": { "description": "Required. ID of security profile of the security monitoring condition.", "type": "string" }, "createTime": { "readOnly": true, "format": "google-datetime", "type": "string", "description": "Output only. The time of the security monitoring condition creation." }, "totalDeployedResources": { "readOnly": true, "format": "int32", "type": "integer", "description": "Output only. Total number of deployed resources within scope." }, "name": { "type": "string", "description": "Identifier. Name of the security monitoring condition resource. Format: organizations/{org}/securityMonitoringConditions/{security_monitoring_condition}" }, "include": { "description": "Include only these resources.", "$ref": "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestResourceArray" }, "apiHubGateway": { "type": "string", "description": "Optional. The API Hub gateway monitored by the security monitoring condition. This should only be set if risk_assessment_type is API_HUB. Format: `projects/{project}/locations/{location}/plugins/{plugin}/instances/{instance}`" }, "includeAllResources": { "description": "Include all resources under the scope.", "$ref": "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestIncludeAll" } } }, "GoogleCloudApigeeV1ScoreComponentRecommendationAction": { "description": "Action to improve security score.", "type": "object", "properties": { "description": { "type": "string", "description": "Description of the action." }, "actionContext": { "description": "Action context for the action.", "$ref": "GoogleCloudApigeeV1ScoreComponentRecommendationActionActionContext" } }, "id": "GoogleCloudApigeeV1ScoreComponentRecommendationAction" }, "GoogleCloudApigeeV1ListSharedFlowsResponse": { "type": "object", "properties": { "sharedFlows": { "type": "array", "items": { "$ref": "GoogleCloudApigeeV1SharedFlow" } } }, "id": "GoogleCloudApigeeV1ListSharedFlowsResponse" }, "GoogleCloudApigeeV1ReferenceConfig": { "id": "GoogleCloudApigeeV1ReferenceConfig", "type": "object", "properties": { "resourceName": { "description": "Name of the referenced resource in the following format: `organizations/{org}/environments/{env}/keystores/{keystore}` Only references to keystore resources are supported.", "type": "string" }, "name": { "description": "Name of the reference in the following format: `organizations/{org}/environments/{env}/references/{reference}`", "type": "string" } } }, "GoogleRpcStatus": { "id": "GoogleRpcStatus", "type": "object", "properties": { "details": { "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", "type": "array", "items": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." } } }, "code": { "description": "The status code, which should be an enum value of google.rpc.Code.", "type": "integer", "format": "int32" }, "message": { "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.", "type": "string" } }, "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)." }, "GoogleCloudApigeeV1RoutingRule": { "id": "GoogleCloudApigeeV1RoutingRule", "type": "object", "properties": { "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" }, "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." }, "basepath": { "type": "string", "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." }, "otherTargets": { "description": "Conflicting targets, which will be resource names specifying either deployment groups or environments.", "type": "array", "items": { "type": "string" } }, "envGroupRevision": { "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.", "format": "int64" }, "updateTime": { "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", "format": "google-datetime" }, "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" } } }, "GoogleCloudApigeeV1ProfileConfigAuthorization": { "type": "object", "properties": {}, "description": "By default, following policies will be included: - JWS - JWT - OAuth - BasicAuth - APIKey", "id": "GoogleCloudApigeeV1ProfileConfigAuthorization" }, "GoogleCloudApigeeV1LlmOperation": { "id": "GoogleCloudApigeeV1LlmOperation", "type": "object", "properties": { "resource": { "description": "Required. REST resource path associated with the API proxy or remote service.", "type": "string" }, "methods": { "items": { "type": "string" }, "type": "array", "description": "Optional. methods refers to the REST verbs as in https://httpwg.org/specs/rfc9110.html For example: GET, POST, PUT, DELETE, etc. They need to be in uppercase. When none specified, all verb types are allowed." }, "model": { "description": "Required. LLM model name associated with the API proxy", "type": "string" } }, "description": "Represents the pairing of REST resource path, model and the actions (verbs) allowed on the resource path." }, "GoogleCloudApigeeV1ListInstanceAttachmentsResponse": { "id": "GoogleCloudApigeeV1ListInstanceAttachmentsResponse", "type": "object", "properties": { "attachments": { "items": { "$ref": "GoogleCloudApigeeV1InstanceAttachment" }, "description": "Attachments for the instance.", "type": "array" }, "nextPageToken": { "type": "string", "description": "Page token that you can include in a ListInstanceAttachments request to retrieve the next page of content. If omitted, no subsequent pages exist." } }, "description": "Response for ListInstanceAttachments." }, "GoogleCloudApigeeV1DnsZonePeeringConfig": { "id": "GoogleCloudApigeeV1DnsZonePeeringConfig", "type": "object", "properties": { "targetProjectId": { "type": "string", "description": "Required. The ID of the project that contains the producer VPC network." }, "targetNetworkId": { "description": "Required. The VPC network where the records for that private DNS zone's namespace are available. Apigee will be performing DNS peering with this VPC network.", "type": "string" } }, "description": "Fields for DNS PEERING zone." }, "GoogleCloudApigeeV1ListSecurityIncidentsResponse": { "id": "GoogleCloudApigeeV1ListSecurityIncidentsResponse", "description": "Response for ListSecurityIncidents.", "type": "object", "properties": { "securityIncidents": { "description": "List of security incidents in the organization", "type": "array", "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." } } }, "GoogleCloudApigeeV1DeveloperMonetizationConfig": { "id": "GoogleCloudApigeeV1DeveloperMonetizationConfig", "type": "object", "properties": { "billingType": { "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." ], "type": "string", "description": "Billing type.", "enum": [ "BILLING_TYPE_UNSPECIFIED", "PREPAID", "POSTPAID" ] } }, "description": "Monetization configuration for the developer." }, "GoogleCloudApigeeV1AccessLoggingConfig": { "id": "GoogleCloudApigeeV1AccessLoggingConfig", "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.", "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Optional. Boolean flag that specifies whether the customer access log feature is enabled." }, "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 )" } } }, "GoogleCloudApigeeV1AppGroupBalanceWallet": { "type": "object", "properties": { "lastCreditTime": { "type": "string", "description": "Output only. Time at which the AppGroup last added credit to the account in milliseconds since epoch.", "readOnly": true, "format": "int64" }, "balance": { "description": "Current remaining balance of the AppGroup for a particular currency.", "$ref": "GoogleTypeMoney" } }, "description": "Wallet used to manage an account balance for a particular currency.", "id": "GoogleCloudApigeeV1AppGroupBalanceWallet" }, "GoogleCloudApigeeV1DataCollector": { "description": "Data collector configuration.", "type": "object", "properties": { "createdAt": { "readOnly": true, "format": "int64", "type": "string", "description": "Output only. The time at which the data collector was created in milliseconds since the epoch." }, "type": { "type": "string", "description": "Immutable. The type of data this data collector will collect.", "enum": [ "TYPE_UNSPECIFIED", "INTEGER", "FLOAT", "STRING", "BOOLEAN", "DATETIME" ], "enumDescriptions": [ "For future compatibility.", "For integer values.", "For float values.", "For string values.", "For boolean values.", "For datetime values." ] }, "name": { "type": "string", "description": "ID of the data collector. Must begin with `dc_`." }, "description": { "type": "string", "description": "A description of the data collector." }, "lastModifiedAt": { "type": "string", "description": "Output only. The time at which the Data Collector was last updated in milliseconds since the epoch.", "readOnly": true, "format": "int64" } }, "id": "GoogleCloudApigeeV1DataCollector" }, "GoogleCloudApigeeV1SecurityProfileScoringConfig": { "type": "object", "properties": { "title": { "description": "Title of the config.", "type": "string" }, "scorePath": { "type": "string", "description": "Path of the component config used for scoring." }, "description": { "type": "string", "description": "Description of the config." } }, "description": "Security configurations to manage scoring.", "id": "GoogleCloudApigeeV1SecurityProfileScoringConfig" }, "GoogleCloudApigeeV1ProfileConfigCORS": { "description": "Checks to see if you have CORS policy in place.", "type": "object", "properties": {}, "id": "GoogleCloudApigeeV1ProfileConfigCORS" }, "GoogleCloudApigeeV1ResourceFile": { "type": "object", "properties": { "name": { "description": "ID of the resource file.", "type": "string" }, "type": { "description": "Resource file type. {{ resource_file_type }}", "type": "string" } }, "description": "Metadata about a resource file.", "id": "GoogleCloudApigeeV1ResourceFile" }, "GoogleCloudApigeeV1AsyncQueryResult": { "id": "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`" } } }, "GoogleCloudApigeeV1RateRange": { "id": "GoogleCloudApigeeV1RateRange", "description": "API call volume range and the fees charged when the total number of API calls is within the range.", "type": "object", "properties": { "start": { "format": "int64", "description": "Starting value of the range. Set to 0 or `null` for the initial range of values.", "type": "string" }, "end": { "format": "int64", "type": "string", "description": "Ending value of the range. Set to 0 or `null` for the last range of values." }, "fee": { "description": "Fee to charge when total number of API calls falls within this range.", "$ref": "GoogleTypeMoney" } } }, "GoogleCloudApigeeV1ArchiveDeployment": { "id": "GoogleCloudApigeeV1ArchiveDeployment", "description": "Archive Deployment information.", "type": "object", "properties": { "gcsUri": { "type": "string", "description": "Input only. The Google Cloud Storage signed URL returned from GenerateUploadUrl and used to upload the Archive zip file." }, "createdAt": { "readOnly": true, "format": "int64", "type": "string", "description": "Output only. The time at which the Archive Deployment was created in milliseconds since the epoch." }, "updatedAt": { "readOnly": true, "format": "int64", "type": "string", "description": "Output only. The time at which the Archive Deployment was updated in milliseconds since the epoch." }, "labels": { "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.", "additionalProperties": { "type": "string" } }, "name": { "description": "Name of the Archive Deployment in the following format: `organizations/{org}/environments/{env}/archiveDeployments/{id}`.", "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}`" } } }, "GoogleCloudApigeeV1Keystore": { "type": "object", "properties": { "name": { "type": "string", "description": "Required. Resource ID for this keystore. Values must match the regular expression `[\\w[:space:].-]{1,255}`." }, "aliases": { "description": "Output only. Aliases in this keystore.", "type": "array", "readOnly": true, "items": { "type": "string" } } }, "description": "Datastore for Certificates and Aliases.", "id": "GoogleCloudApigeeV1Keystore" }, "GoogleCloudApigeeV1AsyncQuery": { "type": "object", "properties": { "created": { "type": "string", "description": "Creation time of the query." }, "error": { "type": "string", "description": "Error is set when query fails." }, "result": { "description": "Result is available only after the query is completed.", "$ref": "GoogleCloudApigeeV1AsyncQueryResult" }, "queryParams": { "description": "Contains information like metrics, dimenstions etc of the AsyncQuery.", "$ref": "GoogleCloudApigeeV1QueryMetadata" }, "self": { "type": "string", "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`" }, "executionTime": { "type": "string", "description": "ExecutionTime is available only after the query is completed." }, "resultFileSize": { "description": "ResultFileSize is available only after the query is completed.", "type": "string" }, "name": { "type": "string", "description": "Asynchronous Query Name." }, "state": { "type": "string", "description": "Query state could be \"enqueued\", \"running\", \"completed\", \"failed\"." }, "updated": { "type": "string", "description": "Last updated timestamp for the query." }, "reportDefinitionId": { "description": "Asynchronous Report ID.", "type": "string" }, "resultRows": { "type": "string", "description": "ResultRows is available only after the query is completed.", "format": "int64" }, "envgroupHostname": { "type": "string", "description": "Hostname is available only when query is executed at host level." } }, "id": "GoogleCloudApigeeV1AsyncQuery" }, "GoogleCloudApigeeV1NodeConfig": { "id": "GoogleCloudApigeeV1NodeConfig", "type": "object", "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" }, "maxNodeCount": { "format": "int64", "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.", "type": "string" }, "currentAggregateNodeCount": { "readOnly": true, "format": "int64", "description": "Output only. The current total number of gateway nodes that each environment currently has across all instances.", "type": "string" } }, "description": "NodeConfig for setting the min/max number of nodes associated with the environment." }, "GoogleCloudApigeeV1RuntimeTraceSamplingConfig": { "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", "properties": { "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." ], "type": "string", "description": "Sampler of distributed tracing. OFF is the default value.", "enum": [ "SAMPLER_UNSPECIFIED", "OFF", "PROBABILITY" ] }, "samplingRate": { "type": "number", "description": "Field sampling rate. This value is only applicable when using the PROBABILITY sampler. The supported values are \u003e 0 and \u003c= 0.5.", "format": "float" } }, "id": "GoogleCloudApigeeV1RuntimeTraceSamplingConfig" }, "GoogleCloudApigeeV1Organization": { "id": "GoogleCloudApigeeV1Organization", "type": "object", "properties": { "state": { "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." ], "enum": [ "STATE_UNSPECIFIED", "CREATING", "ACTIVE", "DELETING", "UPDATING" ], "type": "string", "readOnly": true }, "projectId": { "description": "Output only. Project ID associated with the Apigee organization.", "type": "string", "readOnly": true }, "createdAt": { "description": "Output only. Time that the Apigee organization was created in milliseconds since epoch.", "type": "string", "readOnly": true, "format": "int64" }, "apiConsumerDataEncryptionKeyName": { "description": "Optional. 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/*`", "type": "string" }, "description": { "description": "Optional. Description of the Apigee organization.", "type": "string" }, "subscriptionType": { "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/).", "deprecated": true, "enumDescriptions": [ "Subscription type not specified.", "Full subscription to Apigee has been purchased.", "Subscription to Apigee is free, limited, and used for evaluation purposes only." ], "type": "string", "enum": [ "SUBSCRIPTION_TYPE_UNSPECIFIED", "PAID", "TRIAL" ], "readOnly": true }, "subscriptionPlan": { "enum": [ "SUBSCRIPTION_PLAN_UNSPECIFIED", "SUBSCRIPTION_2021", "SUBSCRIPTION_2024" ], "type": "string", "readOnly": true, "description": "Output only. Subscription plan that the customer has purchased. Output only.", "enumDescriptions": [ "Subscription plan not specified.", "Traditional subscription plan.", "New subscription plan that provides standard proxy and scaled proxy implementation." ] }, "authorizedNetwork": { "type": "string", "description": "Optional. 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`. When changing authorizedNetwork, you must reconfigure VPC peering. After VPC peering with previous network is deleted, [run the following command](https://cloud.google.com/sdk/gcloud/reference/services/vpc-peerings/delete): `gcloud services vpc-peerings delete --network=NETWORK`, where `NETWORK` is the name of the previous network. This will delete the previous Service Networking. Otherwise, you will get the following error: `The resource 'projects/...-tp' is already linked to another shared VPC host 'projects/...-tp`. 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." }, "apiConsumerDataLocation": { "description": "Optional. 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.", "type": "string" }, "networkEgressRestricted": { "description": "Optional. Flag that specifies if internet egress is restricted for VPC Service Controls. Valid only when runtime_type is `CLOUD` and disable_vpc_peering is `true`.", "type": "boolean" }, "properties": { "description": "Optional. Properties defined in the Apigee organization profile.", "$ref": "GoogleCloudApigeeV1Properties" }, "runtimeType": { "type": "string", "description": "Required. Runtime type of the Apigee organization based on the Apigee subscription purchased.", "enum": [ "RUNTIME_TYPE_UNSPECIFIED", "CLOUD", "HYBRID" ], "enumDescriptions": [ "Runtime type not specified.", "Google-managed Apigee runtime.", "User-managed Apigee hybrid runtime." ] }, "caCertificates": { "description": "Output only. Base64-encoded public certificates for the root CA of the Apigee organization. Valid only when [RuntimeType](#RuntimeType) is `CLOUD`. Multiple certificates are used to support certificate rotation.", "type": "array", "readOnly": true, "items": { "type": "string", "format": "byte" } }, "disableVpcPeering": { "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.", "type": "boolean" }, "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." ] }, "displayName": { "type": "string", "description": "Optional. Display name for the Apigee organization. Unused, but reserved for future use." }, "name": { "description": "Output only. Name of the Apigee organization.", "type": "string", "readOnly": true }, "portalDisabled": { "type": "boolean", "description": "Optional. Configuration for the Portals settings." }, "runtimeDatabaseEncryptionKeyName": { "type": "string", "description": "Optional. 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." }, "controlPlaneEncryptionKeyName": { "type": "string", "description": "Optional. 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/*`" }, "expiresAt": { "readOnly": true, "format": "int64", "type": "string", "description": "Output only. Time that the Apigee organization is scheduled for deletion." }, "addonsConfig": { "description": "Optional. Addon configurations of the Apigee organization.", "$ref": "GoogleCloudApigeeV1AddonsConfig" }, "caCertificate": { "description": "Output only. Deprecated: Use `ca_certificates` instead. Base64-encoded public certificate for the root CA of the Apigee organization. Valid only when [RuntimeType](#RuntimeType) is `CLOUD`.", "deprecated": true, "type": "string", "readOnly": true, "format": "byte" }, "lastModifiedAt": { "type": "string", "description": "Output only. Time that the Apigee organization was last modified in milliseconds since epoch.", "readOnly": true, "format": "int64" }, "analyticsRegion": { "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).", "type": "string", "deprecated": true }, "billingType": { "description": "Optional. Billing type of the Apigee organization. See [Apigee pricing](https://cloud.google.com/apigee/pricing).", "enum": [ "BILLING_TYPE_UNSPECIFIED", "SUBSCRIPTION", "EVALUATION", "PAYG" ], "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." ] }, "apigeeProjectId": { "type": "string", "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 }, "attributes": { "items": { "type": "string" }, "description": "Not used by Apigee.", "type": "array" }, "customerName": { "type": "string", "description": "Not used by Apigee." }, "environments": { "readOnly": true, "items": { "type": "string" }, "type": "array", "description": "Output only. List of environments in the Apigee organization." } } }, "GoogleIamV1TestIamPermissionsRequest": { "description": "Request message for `TestIamPermissions` method.", "type": "object", "properties": { "permissions": { "items": { "type": "string" }, "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)." } }, "id": "GoogleIamV1TestIamPermissionsRequest" }, "GoogleCloudApigeeV1OptimizedStatsNode": { "type": "object", "properties": { "data": { "description": "List of data values.", "type": "array", "items": { "type": "any" } } }, "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.", "id": "GoogleCloudApigeeV1OptimizedStatsNode" }, "GoogleCloudApigeeV1SecuritySettings": { "description": "SecuritySettings reflects the current state of the SecuritySettings feature.", "type": "object", "properties": { "name": { "type": "string", "description": "Identifier. Full resource name is always `organizations/{org}/securitySettings`." }, "mlRetrainingFeedbackEnabled": { "description": "Optional. If true the user consents to the use of ML models for Abuse detection.", "type": "boolean" } }, "id": "GoogleCloudApigeeV1SecuritySettings" }, "GoogleCloudApigeeV1ApiCategoryResponse": { "id": "GoogleCloudApigeeV1ApiCategoryResponse", "description": "The API category resource wrapped with response status, error_code, etc.", "type": "object", "properties": { "status": { "type": "string", "description": "Status of the operation." }, "message": { "type": "string", "description": "Description of the operation." }, "errorCode": { "description": "Unique error code for the request, if any.", "type": "string" }, "requestId": { "description": "Unique ID of the request.", "type": "string" }, "data": { "description": "The API category resource.", "$ref": "GoogleCloudApigeeV1ApiCategory" } } }, "GoogleCloudApigeeV1RuntimeAnalyticsConfig": { "id": "GoogleCloudApigeeV1RuntimeAnalyticsConfig", "type": "object", "properties": { "billingPipelineEnabled": { "type": "boolean", "description": "If Runtime should send billing data to AX or not." }, "enabled": { "type": "boolean", "description": "If the Analytics is enabled or not." } }, "description": "Runtime configuration for the Analytics add-on." }, "GoogleCloudApigeeV1Certificate": { "type": "object", "properties": { "certInfo": { "items": { "$ref": "GoogleCloudApigeeV1CertInfo" }, "type": "array", "description": "Chain of certificates under this name." } }, "id": "GoogleCloudApigeeV1Certificate" }, "GoogleCloudApigeeV1Developer": { "id": "GoogleCloudApigeeV1Developer", "type": "object", "properties": { "email": { "type": "string", "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." }, "status": { "description": "Output only. Status of the developer. Valid values are `active` and `inactive`.", "type": "string", "readOnly": true }, "createdAt": { "description": "Output only. Time at which the developer was created in milliseconds since epoch.", "type": "string", "readOnly": true, "format": "int64" }, "appFamily": { "description": "Developer app family.", "type": "string" }, "organizationName": { "type": "string", "description": "Output only. Name of the Apigee organization in which the developer resides.", "readOnly": true }, "companies": { "items": { "type": "string" }, "description": "List of companies associated with the developer.", "type": "array" }, "lastName": { "description": "Required. Last name of the developer.", "type": "string" }, "lastModifiedAt": { "readOnly": true, "format": "int64", "description": "Output only. Time at which the developer was last modified in milliseconds since epoch.", "type": "string" }, "firstName": { "type": "string", "description": "Required. First name of the developer." }, "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" }, "apps": { "description": "List of apps associated with the developer.", "type": "array", "items": { "type": "string" } }, "userName": { "type": "string", "description": "Required. User name of the developer. Not used by Apigee hybrid." }, "attributes": { "type": "array", "description": "Optional. Developer attributes (name/value pairs). The custom attribute limit is 18.", "items": { "$ref": "GoogleCloudApigeeV1Attribute" } }, "accessType": { "description": "Access type.", "type": "string" } } }, "EdgeConfigstoreBundleBadBundle": { "id": "EdgeConfigstoreBundleBadBundle", "type": "object", "properties": { "violations": { "description": "Describes all precondition violations.", "type": "array", "items": { "$ref": "EdgeConfigstoreBundleBadBundleViolation" } } }, "description": "Describes why a bundle is invalid. Intended for use in error details." }, "GoogleCloudApigeeV1ReportInstanceStatusResponse": { "id": "GoogleCloudApigeeV1ReportInstanceStatusResponse", "description": "Placeholder for future enhancements to status reporting protocol", "type": "object", "properties": {} }, "GoogleCloudApigeeV1ListSpacesResponse": { "id": "GoogleCloudApigeeV1ListSpacesResponse", "description": "A response to a ListSpaces request containing the list of organization spaces and a page token for the next page.", "type": "object", "properties": { "spaces": { "type": "array", "description": "List of Apigee organization spaces.", "items": { "$ref": "GoogleCloudApigeeV1Space" } }, "nextPageToken": { "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": "string" } } }, "GoogleCloudApigeeV1Environment": { "id": "GoogleCloudApigeeV1Environment", "type": "object", "properties": { "deploymentType": { "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", "enum": [ "DEPLOYMENT_TYPE_UNSPECIFIED", "PROXY", "ARCHIVE" ], "type": "string", "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." ] }, "createdAt": { "type": "string", "description": "Output only. Creation time of this environment as milliseconds since epoch.", "readOnly": true, "format": "int64" }, "name": { "type": "string", "description": "Required. Name of the environment. Values must match the regular expression `^[.\\\\p{Alnum}-_]{1,255}$`" }, "clientIpResolutionConfig": { "description": "Optional. The algorithm to resolve IP. This will affect Analytics, API Security, and other features that use the client ip. To remove a client ip resolution config, update the field to an empty value. Example: '{ \"clientIpResolutionConfig\" = {} }' For more information, see: https://cloud.google.com/apigee/docs/api-platform/system-administration/client-ip-resolution.", "$ref": "GoogleCloudApigeeV1EnvironmentClientIPResolutionConfig" }, "displayName": { "description": "Optional. Display name for this environment.", "type": "string" }, "state": { "readOnly": true, "type": "string", "enum": [ "STATE_UNSPECIFIED", "CREATING", "ACTIVE", "DELETING", "UPDATING" ], "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." ], "description": "Output only. State of the environment. Values other than ACTIVE means the resource is not ready to use." }, "forwardProxyUri": { "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 only supported scheme is \"http\". 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.", "type": "string" }, "description": { "type": "string", "description": "Optional. Description of the environment." }, "properties": { "description": "Optional. Key-value pairs that may be used for customizing the environment.", "$ref": "GoogleCloudApigeeV1Properties" }, "hasAttachedFlowHooks": { "type": "boolean" }, "lastModifiedAt": { "readOnly": true, "format": "int64", "description": "Output only. Last modification time of this environment as milliseconds since epoch.", "type": "string" }, "apiProxyType": { "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.", "enum": [ "API_PROXY_TYPE_UNSPECIFIED", "PROGRAMMABLE", "CONFIGURABLE" ], "type": "string" }, "type": { "type": "string", "description": "Optional. EnvironmentType selected for the environment.", "enum": [ "ENVIRONMENT_TYPE_UNSPECIFIED", "BASE", "INTERMEDIATE", "COMPREHENSIVE" ], "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." ] }, "nodeConfig": { "description": "Optional. NodeConfig of the environment.", "$ref": "GoogleCloudApigeeV1NodeConfig" } } }, "GoogleCloudApigeeV1ProfileConfigMTLS": { "id": "GoogleCloudApigeeV1ProfileConfigMTLS", "type": "object", "properties": {}, "description": "Checks to see if you have configured mTLS for the target server." }, "GoogleCloudApigeeV1SecurityAssessmentResult": { "type": "object", "properties": { "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" }, "scoringResult": { "description": "The result of the assessment.", "$ref": "GoogleCloudApigeeV1SecurityAssessmentResultScoringResult" }, "error": { "description": "The error status if scoring fails.", "$ref": "GoogleRpcStatus" } }, "description": "The security assessment result for one resource.", "id": "GoogleCloudApigeeV1SecurityAssessmentResult" }, "GoogleCloudApigeeV1CanaryEvaluationMetricLabels": { "id": "GoogleCloudApigeeV1CanaryEvaluationMetricLabels", "description": "Labels that can be used to filter Apigee metrics.", "type": "object", "properties": { "env": { "description": "The environment ID associated with the metrics.", "type": "string" }, "instance_id": { "description": "Required. The instance ID associated with the metrics. In Apigee Hybrid, the value is configured during installation.", "type": "string" }, "location": { "description": "Required. The location associated with the metrics.", "type": "string" } } }, "GoogleCloudApigeeV1OperationMetadataProgress": { "id": "GoogleCloudApigeeV1OperationMetadataProgress", "description": "Information about operation progress.", "type": "object", "properties": { "details": { "type": "object", "description": "The additional details of the progress.", "additionalProperties": { "description": "Properties of the object.", "type": "any" } }, "state": { "enumDescriptions": [ "", "", "", "" ], "description": "State of the operation.", "enum": [ "STATE_UNSPECIFIED", "NOT_STARTED", "IN_PROGRESS", "FINISHED" ], "type": "string" }, "percentDone": { "format": "int32", "description": "The percentage of the operation progress.", "type": "integer" }, "description": { "description": "Description of the operation's progress.", "type": "string" } } }, "GoogleCloudApigeeV1Point": { "id": "GoogleCloudApigeeV1Point", "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.", "type": "object", "properties": { "results": { "items": { "$ref": "GoogleCloudApigeeV1Result" }, "description": "List of results extracted from a given debug point.", "type": "array" }, "id": { "type": "string", "description": "Name of a step in the transaction." } } }, "GoogleCloudApigeeV1AddonsConfig": { "type": "object", "properties": { "integrationConfig": { "description": "Configuration for the Integration add-on.", "$ref": "GoogleCloudApigeeV1IntegrationConfig" }, "advancedApiOpsConfig": { "description": "Configuration for the Advanced API Ops add-on.", "$ref": "GoogleCloudApigeeV1AdvancedApiOpsConfig" }, "monetizationConfig": { "description": "Configuration for the Monetization add-on.", "$ref": "GoogleCloudApigeeV1MonetizationConfig" }, "connectorsPlatformConfig": { "description": "Configuration for the Connectors Platform add-on.", "$ref": "GoogleCloudApigeeV1ConnectorsPlatformConfig" }, "apiSecurityConfig": { "description": "Configuration for the API Security add-on.", "$ref": "GoogleCloudApigeeV1ApiSecurityConfig" }, "analyticsConfig": { "description": "Configuration for the Analytics add-on. Only used in organizations.environments.addonsConfig.", "$ref": "GoogleCloudApigeeV1AnalyticsConfig" } }, "description": "Add-on configurations for the Apigee organization.", "id": "GoogleCloudApigeeV1AddonsConfig" }, "GoogleCloudApigeeV1OptimizedStatsResponse": { "id": "GoogleCloudApigeeV1OptimizedStatsResponse", "type": "object", "properties": { "stats": { "description": "`stats` results.", "$ref": "GoogleCloudApigeeV1OptimizedStatsNode" }, "metaData": { "description": "Metadata information about the query executed.", "$ref": "GoogleCloudApigeeV1Metadata" }, "TimeUnit": { "description": "List of time unit values. Time unit refers to an epoch timestamp value.", "type": "array", "items": { "type": "string", "format": "int64" } }, "resultTruncated": { "description": "Boolean flag that indicates whether the results were truncated based on the limit parameter.", "type": "boolean" } }, "description": "Encapsulates a response format for JavaScript Optimized Scenario." }, "GoogleCloudApigeeV1InstanceDeploymentStatusDeployedRevision": { "id": "GoogleCloudApigeeV1InstanceDeploymentStatusDeployedRevision", "description": "Revisions deployed in the MPs.", "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" } } }, "GoogleCloudApigeeV1Attributes": { "type": "object", "properties": { "attribute": { "description": "List of attributes.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1Attribute" } } }, "id": "GoogleCloudApigeeV1Attributes" }, "GoogleCloudApigeeV1DeveloperAppKey": { "type": "object", "properties": { "issuedAt": { "description": "Time the developer app was created in milliseconds since epoch.", "type": "string", "format": "int64" }, "apiProducts": { "items": { "type": "any" }, "type": "array", "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." }, "attributes": { "items": { "$ref": "GoogleCloudApigeeV1Attribute" }, "type": "array", "description": "List of attributes associated with the credential." }, "expiresAt": { "description": "Time the developer app expires in milliseconds since epoch.", "type": "string", "format": "int64" }, "consumerSecret": { "description": "Secret key.", "type": "string" }, "consumerKey": { "type": "string", "description": "Consumer key." }, "status": { "type": "string", "description": "Status of the credential. Valid values include `approved` or `revoked`." }, "expiresInSeconds": { "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.", "format": "int64" }, "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." } }, "id": "GoogleCloudApigeeV1DeveloperAppKey" }, "GoogleCloudApigeeV1ProfileConfigCategory": { "id": "GoogleCloudApigeeV1ProfileConfigCategory", "type": "object", "properties": { "abuse": { "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.", "$ref": "GoogleCloudApigeeV1ProfileConfigAbuse" }, "authorization": { "description": "Checks to see if you have an authorization policy in place.", "$ref": "GoogleCloudApigeeV1ProfileConfigAuthorization" }, "threat": { "description": "Checks to see if you have a threat protection policy in place.", "$ref": "GoogleCloudApigeeV1ProfileConfigThreat" }, "mediation": { "description": "Checks to see if you have a mediation policy in place.", "$ref": "GoogleCloudApigeeV1ProfileConfigMediation" }, "cors": { "description": "Checks to see if you have CORS policy in place.", "$ref": "GoogleCloudApigeeV1ProfileConfigCORS" }, "mtls": { "description": "Checks to see if you have configured mTLS for the target server.", "$ref": "GoogleCloudApigeeV1ProfileConfigMTLS" } }, "description": "Advanced API Security provides security profile that scores the following categories." }, "GoogleTypeTimeOfDay": { "type": "object", "properties": { "minutes": { "format": "int32", "type": "integer", "description": "Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59." }, "hours": { "format": "int32", "type": "integer", "description": "Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value \"24:00:00\" for scenarios like business closing time." }, "seconds": { "format": "int32", "type": "integer", "description": "Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds." }, "nanos": { "description": "Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999.", "type": "integer", "format": "int32" } }, "description": "Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`.", "id": "GoogleTypeTimeOfDay" }, "GoogleCloudApigeeV1EnvironmentConfigClientIPResolutionConfig": { "description": "Configuration for resolving the client ip.", "type": "object", "properties": { "headerIndexAlgorithm": { "description": "Resolves the client ip based on a custom header.", "$ref": "GoogleCloudApigeeV1EnvironmentConfigClientIPResolutionConfigHeaderIndexAlgorithm" } }, "id": "GoogleCloudApigeeV1EnvironmentConfigClientIPResolutionConfig" }, "GoogleCloudApigeeV1ListInstancesResponse": { "id": "GoogleCloudApigeeV1ListInstancesResponse", "type": "object", "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.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1Instance" } } }, "description": "Response for ListInstances." }, "GoogleCloudApigeeV1ListOrganizationsResponse": { "type": "object", "properties": { "organizations": { "type": "array", "description": "List of Apigee organizations and associated Google Cloud projects.", "items": { "$ref": "GoogleCloudApigeeV1OrganizationProjectMapping" } } }, "id": "GoogleCloudApigeeV1ListOrganizationsResponse" }, "GoogleCloudApigeeV1OperationConfig": { "id": "GoogleCloudApigeeV1OperationConfig", "type": "object", "properties": { "apiSource": { "description": "Required. Name of the API proxy or remote service with which the resources, methods, and quota are associated.", "type": "string" }, "operations": { "items": { "$ref": "GoogleCloudApigeeV1Operation" }, "type": "array", "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." }, "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" }, "attributes": { "items": { "$ref": "GoogleCloudApigeeV1Attribute" }, "type": "array", "description": "Custom attributes associated with the operation." } }, "description": "Binds the resources in an API proxy or remote service with the allowed REST methods and associated quota enforcement." }, "GoogleCloudApigeeV1ResourceConfig": { "id": "GoogleCloudApigeeV1ResourceConfig", "type": "object", "properties": { "location": { "description": "Location of the resource as a URI.", "type": "string" }, "name": { "type": "string", "description": "Resource name in the following format: `organizations/{org}/environments/{env}/resourcefiles/{type}/{file}/revisions/{rev}` Only environment-scoped resource files are supported." } } }, "GoogleTypeInterval": { "id": "GoogleTypeInterval", "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.", "type": "object", "properties": { "startTime": { "format": "google-datetime", "type": "string", "description": "Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start." }, "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." } } }, "GoogleCloudApigeeV1FlowHookConfig": { "id": "GoogleCloudApigeeV1FlowHookConfig", "type": "object", "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" } } }, "GoogleCloudApigeeV1AppGroupSubscription": { "type": "object", "properties": { "lastModifiedAt": { "description": "Output only. Time when the API product subscription was last modified in milliseconds since epoch.", "type": "string", "readOnly": true, "format": "int64" }, "startTime": { "readOnly": true, "format": "int64", "type": "string", "description": "Output only. Time when the API product subscription starts in milliseconds since epoch." }, "endTime": { "type": "string", "description": "Output only. Time when the API product subscription ends in milliseconds since epoch.", "readOnly": true, "format": "int64" }, "name": { "type": "string", "description": "Output only. Name of the API product subscription.", "readOnly": true }, "apiproduct": { "description": "Required. Name of the API product for which the appgroup is purchasing a subscription.", "type": "string" }, "createdAt": { "description": "Output only. Time when the API product subscription was created in milliseconds since epoch.", "type": "string", "readOnly": true, "format": "int64" } }, "description": "AppGroup Subscription details.", "id": "GoogleCloudApigeeV1AppGroupSubscription" }, "GoogleCloudApigeeV1SecurityActionDeny": { "type": "object", "properties": { "responseCode": { "format": "int32", "description": "Optional. The HTTP response code if the Action = DENY.", "type": "integer" } }, "description": "Message that should be set in case of a Deny Action.", "id": "GoogleCloudApigeeV1SecurityActionDeny" }, "GoogleCloudApigeeV1ApimServiceExtensionExtension": { "id": "GoogleCloudApigeeV1ApimServiceExtensionExtension", "description": "Extension configuration for Apigee extension processor service extension.", "type": "object", "properties": { "matchCondition": { "description": "Optional. Match Condition for CEL expression. Refer to https://cloud.google.com/service-extensions/docs/cel-matcher-language-reference for more details.", "type": "string" }, "failOpen": { "type": "boolean", "description": "Optional. Whether this request should fail open." }, "supportedEvents": { "description": "Optional. Supported events for the Service Extension. If not specified, all events are supported.", "type": "array", "items": { "enumDescriptions": [ "Unspecified event.", "Request headers event.", "Request body event.", "Response headers event.", "Response body event.", "Request trailers event.", "Response trailers event." ], "type": "string", "enum": [ "SUPPORTED_EVENT_UNSPECIFIED", "REQUEST_HEADERS", "REQUEST_BODY", "RESPONSE_HEADERS", "RESPONSE_BODY", "REQUEST_TRAILERS", "RESPONSE_TRAILERS" ] } }, "name": { "type": "string", "description": "Required. Name of the `LbTrafficExtension` resource. The name must conform with RFC-1034, is restricted to lower-cased letters, numbers and hyphens, and can have a maximum length of 63 characters. Additionally, the first character must be a letter and the last a letter or a number." }, "hostname": { "description": "Required. One of the hostnames of Apigee EnvGroup where the proxy is deployed. This hostname (i.e FDQN) will be used to route traffic from the specified forwarding rule to the environment in Apigee X instance where the proxy is deployed for handling extension traffic. Format: ^([a-zA-Z0-9. _-])+$", "type": "string" } } }, "GoogleCloudApigeeV1DeleteCustomReportResponse": { "type": "object", "properties": { "message": { "type": "string", "description": "The response contains only a message field." } }, "id": "GoogleCloudApigeeV1DeleteCustomReportResponse" }, "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", "description": "Data type accepted by the data collector.", "enum": [ "TYPE_UNSPECIFIED", "INTEGER", "FLOAT", "STRING", "BOOLEAN", "DATETIME" ] } }, "id": "GoogleCloudApigeeV1DataCollectorConfig" }, "GoogleCloudApigeeV1SecurityProfileV2ProfileAssessmentConfig": { "id": "GoogleCloudApigeeV1SecurityProfileV2ProfileAssessmentConfig", "type": "object", "properties": { "weight": { "enumDescriptions": [ "The weight is unspecified.", "The weight is minor.", "The weight is moderate.", "The weight is major." ], "type": "string", "description": "The weight of the assessment.", "enum": [ "WEIGHT_UNSPECIFIED", "MINOR", "MODERATE", "MAJOR" ] }, "include": { "description": "Include only these Gateway Types.", "$ref": "GoogleCloudApigeeV1SecurityProfileV2ProfileAssessmentConfigApiHubGatewayTypeArray" } }, "description": "The configuration definition for a specific assessment." }, "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestApiHubGatewayArray": { "description": "Message for the array of API Hub Gateways.", "type": "object", "properties": { "gateways": { "description": "Required. The array of API Hub Gateway IDs. Format: `projects/{project}/locations/{location}/plugins/{plugin}/instances/{instance}`", "type": "array", "items": { "type": "string" } } }, "id": "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestApiHubGatewayArray" }, "GoogleCloudApigeeV1GenerateUploadUrlResponse": { "id": "GoogleCloudApigeeV1GenerateUploadUrlResponse", "type": "object", "properties": { "uploadUri": { "description": "The Google Cloud Storage signed URL that can be used to upload a new Archive zip file.", "type": "string" } }, "description": "Response for GenerateUploadUrl method." }, "GoogleCloudApigeeV1TlsInfo": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Required. Enables TLS. If false, neither one-way nor two-way TLS will be enabled." }, "commonName": { "description": "The TLS Common Name of the certificate.", "$ref": "GoogleCloudApigeeV1TlsInfoCommonName" }, "keyStore": { "description": "Required if `client_auth_enabled` is true. The resource ID of the keystore.", "type": "string" }, "clientAuthEnabled": { "type": "boolean", "description": "Optional. Enables two-way TLS." }, "enforce": { "description": "TLS is strictly enforced.", "type": "boolean" }, "keyAlias": { "type": "string", "description": "Required if `client_auth_enabled` is true. The resource ID for the alias containing the private key and cert." }, "protocols": { "type": "array", "description": "The TLS versioins to be used.", "items": { "type": "string" } }, "ciphers": { "type": "array", "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.", "items": { "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." }, "trustStore": { "type": "string", "description": "The resource ID of the truststore." } }, "description": "TLS configuration information for virtual hosts and TargetServers.", "id": "GoogleCloudApigeeV1TlsInfo" }, "GoogleCloudApigeeV1ListKeyValueEntriesResponse": { "description": "The request structure for listing key value map keys and its corresponding values.", "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" }, "keyValueEntries": { "items": { "$ref": "GoogleCloudApigeeV1KeyValueEntry" }, "description": "One or more key value map keys and values.", "type": "array" } }, "id": "GoogleCloudApigeeV1ListKeyValueEntriesResponse" }, "GoogleCloudApigeeV1SecurityProfileEnvironment": { "type": "object", "properties": { "attachTime": { "readOnly": true, "format": "google-datetime", "type": "string", "description": "Output only. Time at which environment was attached to the security profile." }, "environment": { "type": "string", "description": "Output only. Name of the environment.", "readOnly": true } }, "description": "Environment information of attached environments. Scoring an environment is enabled only if it is attached to a security profile.", "id": "GoogleCloudApigeeV1SecurityProfileEnvironment" }, "GoogleCloudApigeeV1ListAppGroupsResponse": { "type": "object", "properties": { "totalSize": { "description": "Total count of AppGroups.", "type": "integer", "format": "int32" }, "appGroups": { "description": "List of AppGroups.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1AppGroup" } }, "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." } }, "description": "ListAppGroupsResponse contains the 0 or more AppGroups, along with the optional page token and the total count of apps.", "id": "GoogleCloudApigeeV1ListAppGroupsResponse" }, "GoogleCloudApigeeV1ListDatastoresResponse": { "id": "GoogleCloudApigeeV1ListDatastoresResponse", "type": "object", "properties": { "datastores": { "items": { "$ref": "GoogleCloudApigeeV1Datastore" }, "type": "array", "description": "A list of datastores" } }, "description": "The response for ListDatastores" }, "GoogleCloudApigeeV1ApimServiceExtension": { "id": "GoogleCloudApigeeV1ApimServiceExtension", "description": "APIM Service Extension is a resource under an Apigee Organization that is used to create APIM Service Extension to route traffic to existing X instances.", "type": "object", "properties": { "createTime": { "readOnly": true, "format": "google-datetime", "type": "string", "description": "Output only. The time that this resource was created on the server." }, "networkConfigs": { "type": "array", "description": "Required. List of network configurations for the APIM service extension.", "items": { "$ref": "GoogleCloudApigeeV1ApimServiceExtensionNetworkConfig" } }, "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." ], "description": "Output only. State of the APIM service extension. Values other than `ACTIVE` mean the resource is not ready to use.", "readOnly": true, "type": "string", "enum": [ "STATE_UNSPECIFIED", "CREATING", "ACTIVE", "DELETING", "UPDATING" ] }, "name": { "description": "Identifier. unique name of the APIM service extension. The name must conform with RFC-1034, is restricted to lower-cased letters, numbers and hyphens, and can have a maximum length of 63 characters. Additionally, the first character must be a letter and the last a letter or a number.", "type": "string" }, "extensionProcessor": { "type": "string", "description": "Required. Name of the proxy deployed in the Apigee X instance." }, "extensions": { "items": { "$ref": "GoogleCloudApigeeV1ApimServiceExtensionExtension" }, "type": "array", "description": "Optional. List of extensions that are part of the service extension. Refer to https://cloud.google.com/service-extensions/docs/quotas#limits for any limits." }, "lbForwardingRule": { "type": "string", "description": "Required. Name of the Google Cloud LB forwarding rule. Format: projects/{project}/regions/{region}/forwardingRules/{forwarding_rule} projects/{project}/global/forwardingRules/{forwarding_rule}" }, "network": { "description": "Required. The network where the forwarding rule is created. Format: projects/{project}/global/networks/{network}", "type": "string" }, "updateTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. The time that this resource was updated on the server.", "type": "string" } } }, "GoogleCloudApigeeV1RuntimeApiSecurityConfig": { "description": "Runtime configuration for the API Security add-on.", "type": "object", "properties": { "enabled": { "type": "boolean", "description": "If the API Security is enabled or not." } }, "id": "GoogleCloudApigeeV1RuntimeApiSecurityConfig" }, "GoogleCloudApigeeV1StatsHostStats": { "id": "GoogleCloudApigeeV1StatsHostStats", "description": "Encapsulates the hostname wrapper: ``` \"hosts\": [ { \"metrics\": [ { \"name\": \"sum(message_count)\", \"values\": [ \"2.52056245E8\" ] } ], \"name\": \"example.com\" } ]```", "type": "object", "properties": { "dimensions": { "items": { "$ref": "GoogleCloudApigeeV1DimensionMetric" }, "description": "List of metrics grouped under dimensions.", "type": "array" }, "name": { "description": "Hostname used in query.", "type": "string" }, "metrics": { "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": "array", "items": { "$ref": "GoogleCloudApigeeV1Metric" } } } }, "GoogleCloudApigeeV1ListTraceConfigOverridesResponse": { "id": "GoogleCloudApigeeV1ListTraceConfigOverridesResponse", "type": "object", "properties": { "nextPageToken": { "type": "string", "description": "Token value that can be passed as `page_token` to retrieve the next page of content." }, "traceConfigOverrides": { "items": { "$ref": "GoogleCloudApigeeV1TraceConfigOverride" }, "description": "List all trace configuration overrides in an environment.", "type": "array" } }, "description": "Response for ListTraceConfigOverrides." }, "GoogleCloudApigeeV1ListSecurityReportsResponse": { "type": "object", "properties": { "securityReports": { "items": { "$ref": "GoogleCloudApigeeV1SecurityReport" }, "type": "array", "description": "The security reports belong to requested resource name." }, "nextPageToken": { "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.", "type": "string" } }, "description": "The response for SecurityReports.", "id": "GoogleCloudApigeeV1ListSecurityReportsResponse" }, "GoogleCloudApigeeV1CustomReportMetric": { "id": "GoogleCloudApigeeV1CustomReportMetric", "description": "This encapsulates a metric property of the form sum(message_count) where name is message_count and function is sum", "type": "object", "properties": { "function": { "description": "aggregate function", "type": "string" }, "name": { "description": "name of the metric", "type": "string" } } }, "GoogleCloudApigeeV1App": { "type": "object", "properties": { "lastModifiedAt": { "type": "string", "description": "Output only. Last modified time as milliseconds since epoch.", "readOnly": true, "format": "int64" }, "developerEmail": { "type": "string", "description": "Email of the developer." }, "developerId": { "type": "string", "description": "ID of the developer." }, "companyName": { "type": "string", "description": "Name of the company that owns the app." }, "credentials": { "readOnly": true, "items": { "$ref": "GoogleCloudApigeeV1Credential" }, "description": "Output only. Set of credentials for the app. Credentials are API key/secret pairs associated with API products.", "type": "array" }, "scopes": { "items": { "type": "string" }, "type": "array", "description": "Scopes to apply to the app. The specified scope names must already exist on the API product that you associate with the app." }, "appId": { "type": "string", "description": "ID of the app." }, "attributes": { "type": "array", "description": "List of attributes.", "items": { "$ref": "GoogleCloudApigeeV1Attribute" } }, "callbackUrl": { "type": "string", "description": "Callback URL used by OAuth 2.0 authorization servers to communicate authorization codes back to apps." }, "name": { "type": "string", "description": "Name of the app." }, "status": { "description": "Status of the credential.", "type": "string" }, "keyExpiresIn": { "format": "int64", "type": "string", "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" }, "createdAt": { "type": "string", "description": "Output only. Unix time when the app was created.", "readOnly": true, "format": "int64" }, "apiProducts": { "items": { "$ref": "GoogleCloudApigeeV1ApiProductRef" }, "description": "List of API products associated with the app.", "type": "array" }, "appGroup": { "description": "Name of the AppGroup", "type": "string" } }, "id": "GoogleCloudApigeeV1App" }, "GoogleCloudApigeeV1EnableSecurityActionRequest": { "type": "object", "properties": {}, "description": "Message to enable a disabled SecurityAction.", "id": "GoogleCloudApigeeV1EnableSecurityActionRequest" }, "GoogleCloudApigeeV1MoveSharedFlowRequest": { "type": "object", "properties": { "space": { "description": "Optional. Resource ID of the space to move the shared flow to. If unspecified, the shared flow will be moved to the organization level.", "type": "string" } }, "description": "Moves a Shared Flow to a different space.", "id": "GoogleCloudApigeeV1MoveSharedFlowRequest" }, "GoogleCloudApigeeV1ListAppGroupAppsResponse": { "description": "Response for ListAppGroupApps", "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" }, "appGroupApps": { "items": { "$ref": "GoogleCloudApigeeV1AppGroupApp" }, "type": "array", "description": "List of AppGroup apps and their credentials." } }, "id": "GoogleCloudApigeeV1ListAppGroupAppsResponse" }, "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" } }, "description": "Encapsulates a response format for JavaScript Optimized Scenario.", "id": "GoogleCloudApigeeV1OptimizedStats" }, "GoogleCloudApigeeV1StatsEnvironmentStats": { "description": "Encapsulates the environment wrapper: ``` \"environments\": [ { \"metrics\": [ { \"name\": \"sum(message_count)\", \"values\": [ \"2.52056245E8\" ] } ], \"name\": \"prod\" } ]```", "type": "object", "properties": { "dimensions": { "items": { "$ref": "GoogleCloudApigeeV1DimensionMetric" }, "type": "array", "description": "List of metrics grouped under dimensions." }, "name": { "type": "string", "description": "Name of the environment." }, "metrics": { "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.", "type": "array" } }, "id": "GoogleCloudApigeeV1StatsEnvironmentStats" }, "GoogleCloudApigeeV1QueryMetadata": { "type": "object", "properties": { "metrics": { "items": { "type": "string" }, "description": "Metrics of the AsyncQuery. Example: [\"name:message_count,func:sum,alias:sum_message_count\"]", "type": "array" }, "startTimestamp": { "type": "string", "description": "Start timestamp of the query range." }, "endTimestamp": { "type": "string", "description": "End timestamp of the query range." }, "outputFormat": { "description": "Output format.", "type": "string" }, "timeUnit": { "type": "string", "description": "Query GroupBy time unit." }, "dimensions": { "items": { "type": "string" }, "description": "Dimensions of the AsyncQuery.", "type": "array" } }, "id": "GoogleCloudApigeeV1QueryMetadata" }, "GoogleCloudApigeeV1ResourceStatus": { "description": "The status of a resource loaded in the runtime.", "type": "object", "properties": { "resource": { "type": "string", "description": "The resource name. Currently only two resources are supported: EnvironmentGroup - organizations/{org}/envgroups/{envgroup} EnvironmentConfig - organizations/{org}/environments/{environment}/deployedConfig" }, "totalReplicas": { "format": "int32", "description": "The total number of replicas that should have this resource.", "type": "integer" }, "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" }, "revisions": { "items": { "$ref": "GoogleCloudApigeeV1RevisionStatus" }, "type": "array", "description": "Revisions of the resource currently deployed in the instance." } }, "id": "GoogleCloudApigeeV1ResourceStatus" }, "GoogleCloudApigeeV1QueryTimeSeriesStatsResponse": { "description": "Represents security stats result as a collection of time series sequences.", "type": "object", "properties": { "nextPageToken": { "type": "string", "description": "Next page token." }, "columns": { "description": "Column names corresponding to the same order as the inner values in the stats field.", "type": "array", "items": { "type": "string" } }, "values": { "description": "Results of the query returned as a JSON array.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1QueryTimeSeriesStatsResponseSequence" } } }, "id": "GoogleCloudApigeeV1QueryTimeSeriesStatsResponse" }, "GoogleCloudApigeeV1ListSecurityProfileRevisionsResponse": { "type": "object", "properties": { "securityProfiles": { "items": { "$ref": "GoogleCloudApigeeV1SecurityProfile" }, "type": "array", "description": "List of security profile revisions. The revisions may be attached or unattached to any environment." }, "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." } }, "description": "Response for ListSecurityProfileRevisions.", "id": "GoogleCloudApigeeV1ListSecurityProfileRevisionsResponse" }, "GoogleCloudApigeeV1ScheduledMaintenance": { "id": "GoogleCloudApigeeV1ScheduledMaintenance", "type": "object", "properties": { "startTime": { "description": "Output only. The start time (UTC) of the scheduled maintenance.", "type": "string", "readOnly": true, "format": "google-datetime" } }, "description": "Scheduled maintenance information for an instance." }, "GoogleCloudApigeeV1GraphQLOperationGroup": { "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.", "type": "object", "properties": { "operationConfigs": { "description": "Required. List of operation configurations for either Apigee API proxies or other remote services that are associated with this API product.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1GraphQLOperationConfig" } }, "operationConfigType": { "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.", "type": "string" } } }, "GoogleCloudApigeeV1ListDebugSessionsResponse": { "id": "GoogleCloudApigeeV1ListDebugSessionsResponse", "type": "object", "properties": { "nextPageToken": { "type": "string", "description": "Page token that you can include in a ListDebugSessionsRequest to retrieve the next page. If omitted, no subsequent pages exist." }, "sessions": { "description": "Session info that includes debug session ID and the first transaction creation timestamp.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1Session" } } } }, "GoogleCloudApigeeV1MetricAggregation": { "id": "GoogleCloudApigeeV1MetricAggregation", "type": "object", "properties": { "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.", "enum": [ "ORDER_UNSPECIFIED", "ASCENDING", "DESCENDING" ], "type": "string", "enumDescriptions": [ "Unspecified order. Default is Descending.", "Ascending sort order.", "Descending sort order." ] }, "name": { "description": "Name of the metric", "type": "string" }, "aggregation": { "type": "string", "description": "Aggregation function associated with the metric.", "enum": [ "AGGREGATION_FUNCTION_UNSPECIFIED", "AVG", "SUM", "MIN", "MAX", "COUNT_DISTINCT" ], "enumDescriptions": [ "Unspecified Aggregation function.", "Average.", "Summation.", "Min.", "Max.", "Count distinct" ] } }, "description": "The optionally aggregated metric to query with its ordering." }, "GoogleCloudApigeeV1DeploymentChangeReport": { "type": "object", "properties": { "routingChanges": { "type": "array", "description": "All routing changes that may result from a deployment request.", "items": { "$ref": "GoogleCloudApigeeV1DeploymentChangeReportRoutingChange" } }, "validationErrors": { "description": "Validation errors that would cause the deployment change request to be rejected.", "$ref": "GoogleRpcPreconditionFailure" }, "routingConflicts": { "items": { "$ref": "GoogleCloudApigeeV1DeploymentChangeReportRoutingConflict" }, "description": "All base path conflicts detected for a deployment request.", "type": "array" } }, "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.", "id": "GoogleCloudApigeeV1DeploymentChangeReport" }, "GoogleCloudApigeeV1ListApiCategoriesResponse": { "type": "object", "properties": { "requestId": { "description": "Unique ID of the request.", "type": "string" }, "status": { "type": "string", "description": "Status of the operation." }, "message": { "type": "string", "description": "Description of the operation." }, "errorCode": { "description": "Unique error code for the request, if any.", "type": "string" }, "data": { "description": "The API category resources.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1ApiCategory" } } }, "description": "The response for `ListApiCategoriesRequest`. Next ID: 6", "id": "GoogleCloudApigeeV1ListApiCategoriesResponse" }, "GoogleCloudApigeeV1DnsZone": { "id": "GoogleCloudApigeeV1DnsZone", "description": "A DNS zone is a resource under an Apigee organization that is used to create a DNS peering with Apigee's network. DNS peering will let Apigee instances resolve the hostnames created in a peered network.", "type": "object", "properties": { "domain": { "description": "Required. The domain name for hosts in this private zone, for instance \"example.com.\".", "type": "string" }, "peeringConfig": { "description": "DNS PEERING zone configuration.", "$ref": "GoogleCloudApigeeV1DnsZonePeeringConfig" }, "name": { "type": "string", "description": "Identifier. Unique name for the resource. Defined by the server Format: \"organizations/{organization}/dnsZones/{dns_zone}\"." }, "updateTime": { "type": "string", "description": "Output only. The time that this resource was updated on the server.", "readOnly": true, "format": "google-datetime" }, "state": { "description": "Output only. State of the DNS Peering. Values other than `ACTIVE` mean 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." ], "type": "string", "enum": [ "STATE_UNSPECIFIED", "CREATING", "ACTIVE", "DELETING", "UPDATING" ], "readOnly": true }, "createTime": { "description": "Output only. The time that this resource was created on the server.", "type": "string", "readOnly": true, "format": "google-datetime" }, "description": { "type": "string", "description": "Required. Description of the resource. String of at most 1024 characters associated with this resource for the user's convenience." } } }, "GoogleCloudApigeeV1ListHybridIssuersResponse": { "type": "object", "properties": { "issuers": { "description": "Lists of hybrid services and its trusted issuer email ids.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1ServiceIssuersMapping" } } }, "id": "GoogleCloudApigeeV1ListHybridIssuersResponse" }, "GoogleCloudApigeeV1ListDeveloperAppsResponse": { "type": "object", "properties": { "app": { "description": "List of developer apps and their credentials.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1DeveloperApp" } } }, "id": "GoogleCloudApigeeV1ListDeveloperAppsResponse" }, "GoogleCloudApigeeV1ListSecurityMonitoringConditionsResponse": { "id": "GoogleCloudApigeeV1ListSecurityMonitoringConditionsResponse", "description": "Response for ListSecurityMonitoringConditions.", "type": "object", "properties": { "securityMonitoringConditions": { "items": { "$ref": "GoogleCloudApigeeV1SecurityMonitoringCondition" }, "description": "List of security monitoring conditions in the organization.", "type": "array" }, "nextPageToken": { "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": "string" } } }, "GoogleCloudApigeeV1Query": { "type": "object", "properties": { "dimensions": { "description": "A list of dimensions. https://docs.apigee.com/api-platform/analytics/analytics-reference#dimensions", "type": "array", "items": { "type": "string" } }, "metrics": { "type": "array", "description": "A list of Metrics.", "items": { "$ref": "GoogleCloudApigeeV1QueryMetric" } }, "filter": { "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", "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", "description": "Maximum number of rows that can be returned in the result.", "type": "integer" }, "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" }, "outputFormat": { "description": "Valid values include: `csv` or `json`. Defaults to `json`. Note: Configure the delimiter for CSV output using the csvDelimiter property.", "type": "string" }, "name": { "type": "string", "description": "Asynchronous Query Name." }, "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." }, "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." }, "reportDefinitionId": { "type": "string", "description": "Asynchronous Report ID." } }, "id": "GoogleCloudApigeeV1Query" }, "GoogleCloudApigeeV1SecurityAssessmentResultResourceApiHubDeploymentDetails": { "description": "Additional details if the resource is an API Hub deployment.", "type": "object", "properties": { "displayName": { "type": "string", "description": "The display name of the API Hub deployment." }, "gatewayType": { "enumDescriptions": [ "Gateway type is not specified.", "Gateway is Apigee X for API Hub.", "Gateway is Apigee Hybrid for API Hub.", "Gateway is Apigee Edge for API Hub.", "Gateway is Apigee OPDK for API Hub." ], "description": "The gateway type for the API Hub deployment.", "enum": [ "API_HUB_GATEWAY_TYPE_UNSPECIFIED", "APIGEE_X", "APIGEE_HYBRID", "APIGEE_EDGE", "APIGEE_OPDK" ], "type": "string" }, "sourceProject": { "type": "string", "description": "The source project for the API Hub deployment." }, "resourceUri": { "description": "The resource uri for the API Hub deployment.", "type": "string" }, "gateway": { "description": "The gateway for the API Hub deployment. Format: `projects/{project}/locations/{location}/plugins/{plugin}/instances/{instance}`", "type": "string" } }, "id": "GoogleCloudApigeeV1SecurityAssessmentResultResourceApiHubDeploymentDetails" }, "GoogleCloudApigeeV1DeploymentConfig": { "type": "object", "properties": { "location": { "description": "Location of the API proxy bundle as a URI.", "type": "string" }, "proxyUid": { "description": "Unique ID of the API proxy revision.", "type": "string" }, "basePath": { "description": "Base path where the application will be hosted. Defaults to \"/\".", "type": "string" }, "endpoints": { "description": "A mapping from basepaths to proxy endpoint names in this proxy. Not populated for shared flows.", "additionalProperties": { "type": "string" }, "type": "object" }, "attributes": { "description": "Additional key-value metadata for the deployment.", "additionalProperties": { "type": "string" }, "type": "object" }, "uid": { "description": "Unique ID. The ID will only change if the deployment is deleted and recreated.", "type": "string" }, "deploymentGroups": { "type": "array", "description": "The list of deployment groups in which this proxy should be deployed. Not currently populated for shared flows.", "items": { "type": "string" } }, "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}`" }, "serviceAccount": { "description": "The service account identity associated with this deployment. If non-empty, will be in the following format: `projects/-/serviceAccounts/{account_email}`", "type": "string" } }, "description": "NEXT ID: 11", "id": "GoogleCloudApigeeV1DeploymentConfig" }, "GoogleCloudApigeeV1Stats": { "type": "object", "properties": { "metaData": { "description": "Metadata information.", "$ref": "GoogleCloudApigeeV1Metadata" }, "environments": { "items": { "$ref": "GoogleCloudApigeeV1StatsEnvironmentStats" }, "description": "List of query results on the environment level.", "type": "array" }, "hosts": { "type": "array", "description": "List of query results grouped by host.", "items": { "$ref": "GoogleCloudApigeeV1StatsHostStats" } } }, "description": "Encapsulates a `stats` response.", "id": "GoogleCloudApigeeV1Stats" }, "GoogleCloudApigeeV1Metadata": { "id": "GoogleCloudApigeeV1Metadata", "type": "object", "properties": { "errors": { "items": { "type": "string" }, "description": "List of error messages as strings.", "type": "array" }, "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" } } }, "description": "Encapsulates additional information about query execution." }, "GoogleCloudApigeeV1ListOfDevelopersResponse": { "type": "object", "properties": { "developer": { "items": { "$ref": "GoogleCloudApigeeV1Developer" }, "description": "List of developers.", "type": "array" } }, "id": "GoogleCloudApigeeV1ListOfDevelopersResponse" }, "GoogleCloudApigeeV1TraceSamplingConfig": { "type": "object", "properties": { "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." ], "type": "string", "description": "Sampler of distributed tracing. OFF is the default value.", "enum": [ "SAMPLER_UNSPECIFIED", "OFF", "PROBABILITY" ] }, "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" } }, "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.", "id": "GoogleCloudApigeeV1TraceSamplingConfig" }, "GoogleCloudApigeeV1UpdateSecurityIncidentRequest": { "id": "GoogleCloudApigeeV1UpdateSecurityIncidentRequest", "type": "object", "properties": { "updateMask": { "description": "Required. The list of fields to update. Allowed fields are: LINT.IfChange(allowed_update_fields_comment) - observability LINT.ThenChange()", "type": "string", "format": "google-fieldmask" }, "securityIncident": { "description": "Required. The security incident to update. Must contain all existing populated fields of the current incident.", "$ref": "GoogleCloudApigeeV1SecurityIncident" } }, "description": "Request for UpdateSecurityIncident." }, "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestResourceArrayResource": { "description": "Resource for which we are computing security assessment.", "type": "object", "properties": { "type": { "enumDescriptions": [ "ResourceType not specified.", "Resource is an Apigee Proxy.", "Resource is an API Hub deployment." ], "description": "Required. Type of this resource.", "enum": [ "RESOURCE_TYPE_UNSPECIFIED", "API_PROXY", "API_HUB_DEPLOYMENT" ], "type": "string" }, "name": { "description": "Required. Name of this resource. For an Apigee API Proxy, this should be the id of the API proxy. For an API Hub Deployment, this should be the id of the deployment.", "type": "string" } }, "id": "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestResourceArrayResource" }, "GoogleCloudApigeeV1ListArchiveDeploymentsResponse": { "type": "object", "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." } }, "description": "Response for ListArchiveDeployments method.", "id": "GoogleCloudApigeeV1ListArchiveDeploymentsResponse" }, "GoogleCloudApigeeV1ListApiProxiesResponse": { "type": "object", "properties": { "proxies": { "type": "array", "items": { "$ref": "GoogleCloudApigeeV1ApiProxy" } } }, "id": "GoogleCloudApigeeV1ListApiProxiesResponse" }, "GoogleCloudApigeeV1EnvironmentGroupAttachment": { "type": "object", "properties": { "environment": { "description": "Required. ID of the attached environment.", "type": "string" }, "name": { "description": "ID of the environment group attachment.", "type": "string" }, "createdAt": { "readOnly": true, "format": "int64", "type": "string", "description": "Output only. The time at which the environment group attachment was created as milliseconds since epoch." }, "environmentGroupId": { "readOnly": true, "description": "Output only. ID of the environment group.", "type": "string" } }, "description": "EnvironmentGroupAttachment is a resource which defines an attachment of an environment to an environment group.", "id": "GoogleCloudApigeeV1EnvironmentGroupAttachment" }, "GoogleCloudApigeeV1DimensionMetric": { "type": "object", "properties": { "individualNames": { "description": "Individual dimension names. E.g. [\"dim1_name\", \"dim2_name\"].", "type": "array", "items": { "type": "string" } }, "name": { "deprecated": true, "type": "string", "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." }, "metrics": { "type": "array", "description": "List of metrics.", "items": { "$ref": "GoogleCloudApigeeV1Metric" } } }, "description": "Encapsulates a metric grouped by dimension.", "id": "GoogleCloudApigeeV1DimensionMetric" }, "GoogleCloudApigeeV1GraphQLOperationConfig": { "id": "GoogleCloudApigeeV1GraphQLOperationConfig", "description": "Binds the resources in a proxy or remote service with the GraphQL operation and its associated quota enforcement.", "type": "object", "properties": { "attributes": { "description": "Custom attributes associated with the operation.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1Attribute" } }, "apiSource": { "description": "Required. Name of the API proxy endpoint or remote service with which the GraphQL operation and quota are associated.", "type": "string" }, "operations": { "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", "items": { "$ref": "GoogleCloudApigeeV1GraphQLOperation" } }, "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" } } }, "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequest": { "description": "Request for BatchComputeSecurityAssessmentResults.", "type": "object", "properties": { "scope": { "description": "Optional. Scope of the resources for the computation. When computing scores for Apigee proxies, the scope should be set to the environment of the resources. When computing scores for API Hub deployments, api_hub_scope should be set instead.", "type": "string" }, "include": { "description": "Include only these resources.", "$ref": "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestResourceArray" }, "pageSize": { "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.", "format": "int32" }, "apiHubGateways": { "description": "An array of API Hub Gateways to assess. A maximum of 3 gateways can be assessed.", "$ref": "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestApiHubGatewayArray" }, "apiHubApis": { "description": "An array of API Hub APIs to assess. A maximum of 1 API can be assessed.", "$ref": "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestApiHubApiArray" }, "profile": { "description": "Required. Name of the profile that is used for computation.", "type": "string" }, "pageToken": { "description": "Optional. A page token, received from a previous `BatchComputeSecurityAssessmentResults` call. Provide this to retrieve the subsequent page.", "type": "string" }, "includeAllResources": { "description": "Include all resources under the scope.", "$ref": "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestIncludeAll" } }, "id": "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequest" }, "GoogleCloudApigeeV1ExpireDeveloperSubscriptionRequest": { "id": "GoogleCloudApigeeV1ExpireDeveloperSubscriptionRequest", "type": "object", "properties": {}, "description": "Request for ExpireDeveloperSubscription." }, "GoogleCloudApigeeV1ApiSecurityRuntimeConfig": { "type": "object", "properties": { "location": { "items": { "type": "string" }, "description": "A list of up to 5 Cloud Storage Blobs that contain SecurityActions.", "type": "array" }, "name": { "type": "string", "description": "Name of the environment API Security Runtime configuration resource. Format: `organizations/{org}/environments/{env}/apiSecurityRuntimeConfig`" }, "updateTime": { "format": "google-datetime", "type": "string", "description": "Time that the API Security Runtime configuration was updated." }, "revisionId": { "format": "int64", "description": "Revision ID of the API Security Runtime configuration. The higher the value, the more recently the configuration was deployed.", "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." } }, "description": "Response for GetApiSecurityRuntimeConfig[EnvironmentService.GetApiSecurityRuntimeConfig].", "id": "GoogleCloudApigeeV1ApiSecurityRuntimeConfig" }, "GoogleCloudApigeeV1LlmOperationConfig": { "description": "Binds the resources in an API proxy or remote service with the allowed REST methods and associated quota enforcement.", "type": "object", "properties": { "attributes": { "description": "Optional. Custom attributes associated with the operation.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1Attribute" } }, "llmOperations": { "items": { "$ref": "GoogleCloudApigeeV1LlmOperation" }, "description": "Required. List of resource/method/model for the API proxy to which quota will applied. **Note**: Currently, you can specify only a single resource/method/model mapping. The call will fail if more than one resource/method/model mappings are provided.", "type": "array" }, "llmTokenQuota": { "description": "Required. LLM token Quota parameters to be enforced for the resources, methods, and API source & LLM model combination. If none are specified, quota enforcement will not be done.", "$ref": "GoogleCloudApigeeV1LlmTokenQuota" }, "apiSource": { "description": "Required. Name of the API proxy or remote service with which the resources, methods, and quota are associated.", "type": "string" } }, "id": "GoogleCloudApigeeV1LlmOperationConfig" }, "GoogleCloudApigeeV1APIProductAssociation": { "id": "GoogleCloudApigeeV1APIProductAssociation", "type": "object", "properties": { "status": { "type": "string", "description": "The API product credential associated status. Valid values are `approved` or `revoked`." }, "apiproduct": { "description": "API product to be associated with the credential.", "type": "string" } }, "description": "APIProductAssociation has the API product and its administrative state association." }, "GoogleCloudApigeeV1OperationMetadata": { "type": "object", "properties": { "operationType": { "enumDescriptions": [ "", "", "", "" ], "type": "string", "enum": [ "OPERATION_TYPE_UNSPECIFIED", "INSERT", "DELETE", "UPDATE" ] }, "targetResourceName": { "description": "Name of the resource for which the operation is operating on.", "type": "string" }, "state": { "enum": [ "STATE_UNSPECIFIED", "NOT_STARTED", "IN_PROGRESS", "FINISHED" ], "type": "string", "enumDescriptions": [ "", "", "", "" ] }, "warnings": { "items": { "type": "string" }, "description": "Warnings encountered while executing the operation.", "type": "array" }, "progress": { "description": "Progress of the operation.", "$ref": "GoogleCloudApigeeV1OperationMetadataProgress" } }, "description": "Metadata describing an Operation.", "id": "GoogleCloudApigeeV1OperationMetadata" }, "GoogleCloudApigeeV1Metric": { "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\"] }```", "type": "object", "properties": { "values": { "items": { "type": "any" }, "description": "List of metric values. Possible value formats include: `\"values\":[\"39.0\"]` or `\"values\":[ { \"value\": \"39.0\", \"timestamp\": 1232434354} ]`", "type": "array" }, "name": { "type": "string", "description": "Metric name." } }, "id": "GoogleCloudApigeeV1Metric" }, "GoogleCloudApigeeV1GraphQLOperation": { "type": "object", "properties": { "operation": { "type": "string", "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." }, "operationTypes": { "description": "Required. GraphQL operation types. Valid values include `query` or `mutation`. **Note**: Apigee does not currently support `subscription` types.", "type": "array", "items": { "type": "string" } } }, "description": "Represents the pairing of GraphQL operation types and the GraphQL operation name.", "id": "GoogleCloudApigeeV1GraphQLOperation" }, "GoogleCloudApigeeV1SecurityReportMetadata": { "id": "GoogleCloudApigeeV1SecurityReportMetadata", "type": "object", "properties": { "endTimestamp": { "description": "End timestamp of the query range.", "type": "string", "format": "google-datetime" }, "timeUnit": { "description": "Query GroupBy time unit. Example: \"seconds\", \"minute\", \"hour\"", "type": "string" }, "dimensions": { "items": { "type": "string" }, "type": "array", "description": "Dimensions of the SecurityReport." }, "mimeType": { "type": "string", "description": "MIME type / Output format." }, "metrics": { "items": { "type": "string" }, "type": "array", "description": "Metrics of the SecurityReport. Example: [\"name:bot_count,func:sum,alias:sum_bot_count\"]" }, "startTimestamp": { "format": "google-datetime", "type": "string", "description": "Start timestamp of the query range." } }, "description": "Metadata for the security report." }, "GoogleCloudApigeeV1ListEndpointAttachmentsResponse": { "type": "object", "properties": { "endpointAttachments": { "items": { "$ref": "GoogleCloudApigeeV1EndpointAttachment" }, "type": "array", "description": "Endpoint attachments in the specified organization." }, "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" } }, "description": "Response for ListEndpointAttachments method.", "id": "GoogleCloudApigeeV1ListEndpointAttachmentsResponse" }, "GoogleCloudApigeeV1MaintenanceUpdatePolicyMaintenanceWindow": { "id": "GoogleCloudApigeeV1MaintenanceUpdatePolicyMaintenanceWindow", "description": "MaintenanceWindow specifies the preferred day of the week and time of day to perform maintenance.", "type": "object", "properties": { "day": { "enumDescriptions": [ "The day of the week is unspecified.", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday" ], "type": "string", "description": "Required. Preferred day of the week for maintenance, e.g. MONDAY, TUESDAY, etc.", "enum": [ "DAY_OF_WEEK_UNSPECIFIED", "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY" ] }, "startTime": { "description": "Required. The start time (UTC) of the maintenance window.", "$ref": "GoogleTypeTimeOfDay" } } }, "GoogleCloudApigeeV1SecurityReportResultView": { "description": "The response for security report result view APIs.", "type": "object", "properties": { "error": { "type": "string", "description": "Error message when there is a failure." }, "metadata": { "description": "Metadata contains information like metrics, dimenstions etc of the security report.", "$ref": "GoogleCloudApigeeV1SecurityReportMetadata" }, "code": { "type": "integer", "description": "Error code when there is a failure.", "format": "int32" }, "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" } } }, "id": "GoogleCloudApigeeV1SecurityReportResultView" }, "GoogleCloudApigeeV1ListSecurityFeedbackResponse": { "type": "object", "properties": { "securityFeedback": { "description": "List of SecurityFeedback reports.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1SecurityFeedback" } }, "nextPageToken": { "type": "string", "description": "A token that can be sent as `page_token` in `ListSecurityFeedbackRequest` to retrieve the next page. If this field is omitted, there are no subsequent pages." } }, "description": "Response for ListSecurityFeedback", "id": "GoogleCloudApigeeV1ListSecurityFeedbackResponse" }, "GoogleCloudApigeeV1EntityMetadata": { "type": "object", "properties": { "createdAt": { "type": "string", "description": "Time at which the API proxy was created, in milliseconds since epoch.", "format": "int64" }, "subType": { "description": "The type of entity described", "type": "string" }, "lastModifiedAt": { "format": "int64", "type": "string", "description": "Time at which the API proxy was most recently modified, in milliseconds since epoch." } }, "description": "Metadata common to many entities in this API.", "id": "GoogleCloudApigeeV1EntityMetadata" }, "GoogleCloudApigeeV1AnalyticsConfig": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Whether the Analytics add-on is enabled." }, "state": { "readOnly": true, "enum": [ "ADDON_STATE_UNSPECIFIED", "ENABLING", "ENABLED", "DISABLING", "DISABLED" ], "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." ], "description": "Output only. The state of the Analytics add-on." }, "expireTimeMillis": { "description": "Output only. Time at which the Analytics add-on expires in milliseconds since epoch. If unspecified, the add-on will never expire.", "type": "string", "readOnly": true, "format": "int64" }, "updateTime": { "readOnly": true, "format": "google-datetime", "type": "string", "description": "Output only. The latest update time." } }, "description": "Configuration for the Analytics add-on.", "id": "GoogleCloudApigeeV1AnalyticsConfig" }, "GoogleCloudApigeeV1GraphqlDocumentation": { "id": "GoogleCloudApigeeV1GraphqlDocumentation", "description": "GraphQL documentation for a catalog item.", "type": "object", "properties": { "schema": { "description": "Required. The documentation file contents for the GraphQL schema.", "$ref": "GoogleCloudApigeeV1DocumentationFile" }, "endpointUri": { "type": "string", "description": "Required. The GraphQL endpoint URI to be queried by API consumers. Max length is 2,083 characters." } } }, "EdgeConfigstoreBundleBadBundleViolation": { "type": "object", "properties": { "filename": { "type": "string", "description": "The filename (including relative path from the bundle root) in which the error occurred." }, "description": { "description": "A description of why the bundle is invalid and how to fix it.", "type": "string" } }, "description": "A message type used to describe a single bundle validation error.", "id": "EdgeConfigstoreBundleBadBundleViolation" }, "GoogleCloudApigeeV1AccessGet": { "type": "object", "properties": { "name": { "type": "string" }, "value": { "type": "string" } }, "description": "Get action. For example, \"Get\" : { \"name\" : \"target.name\", \"value\" : \"default\" }", "id": "GoogleCloudApigeeV1AccessGet" }, "GoogleCloudApigeeV1GenerateDownloadUrlResponse": { "type": "object", "properties": { "downloadUri": { "type": "string", "description": "The Google Cloud Storage signed URL that can be used to download the Archive zip file." } }, "description": "Response for GenerateDownloadUrl method.", "id": "GoogleCloudApigeeV1GenerateDownloadUrlResponse" }, "GoogleCloudApigeeV1ApimServiceExtensionNetworkConfig": { "id": "GoogleCloudApigeeV1ApimServiceExtensionNetworkConfig", "type": "object", "properties": { "region": { "description": "Required. The region for the PSC NEG.", "type": "string" }, "subnet": { "description": "Required. The subnet for the PSC NEG. Format: projects/{project}/regions/{region}/subnetworks/{subnet}", "type": "string" } }, "description": "Network configuration for the APIM service extension." }, "GoogleCloudApigeeV1Result": { "id": "GoogleCloudApigeeV1Result", "type": "object", "properties": { "properties": { "description": "Name value pairs used for DebugInfo ActionResult.", "$ref": "GoogleCloudApigeeV1Properties" }, "reasonPhrase": { "type": "string", "description": "HTTP response phrase" }, "accessList": { "description": "A list of variable access actions agaist the api proxy. Supported values: Get, Set, Remove.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1Access" } }, "ActionResult": { "description": "Type of the action result. Can be one of the five: DebugInfo, RequestMessage, ResponseMessage, ErrorMessage, VariableAccess", "type": "string" }, "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\"`" }, "statusCode": { "type": "string", "description": "HTTP response code" }, "verb": { "type": "string", "description": "HTTP method verb" }, "content": { "type": "string", "description": "Error message content. for example, \"content\" : \"{\\\"fault\\\":{\\\"faultstring\\\":\\\"API timed out\\\",\\\"detail\\\":{\\\"errorcode\\\":\\\"flow.APITimedOut\\\"}}}\"" }, "headers": { "items": { "$ref": "GoogleCloudApigeeV1Property" }, "type": "array", "description": "A list of HTTP headers. for example, '\"headers\" : [ { \"name\" : \"Content-Length\", \"value\" : \"83\" }, { \"name\" : \"Content-Type\", \"value\" : \"application/json\" } ]'" }, "uRI": { "description": "The relative path of the api proxy. for example, `\"uRI\" : \"/iloveapis\"`", "type": "string" } }, "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" }, "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.", "type": "object", "properties": { "completed": { "description": "Flag indicating whether a transaction is completed or not", "type": "boolean" }, "point": { "items": { "$ref": "GoogleCloudApigeeV1Point" }, "type": "array", "description": "List of debug data collected by runtime plane at various defined points in the flow." } }, "id": "GoogleCloudApigeeV1DebugSessionTransaction" }, "GoogleIamV1AuditConfig": { "type": "object", "properties": { "service": { "type": "string", "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." }, "auditLogConfigs": { "items": { "$ref": "GoogleIamV1AuditLogConfig" }, "type": "array", "description": "The configuration for logging of each type of permission." } }, "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" }, "GoogleCloudApigeeV1EnvironmentConfigClientIPResolutionConfigHeaderIndexAlgorithm": { "id": "GoogleCloudApigeeV1EnvironmentConfigClientIPResolutionConfigHeaderIndexAlgorithm", "type": "object", "properties": { "ipHeaderIndex": { "format": "int32", "type": "integer", "description": "The index of the ip in the header. (By default, value is 0 if missing)" }, "ipHeaderName": { "description": "The name of the header to extract the client ip from.", "type": "string" } }, "description": "Resolves the client ip based on a custom header." }, "GoogleCloudApigeeV1CreditAppGroupBalanceRequest": { "description": "Request for CreditAppGroupBalance.", "type": "object", "properties": { "transactionAmount": { "description": "Required. 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" }, "transactionId": { "type": "string", "description": "Required. 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." } }, "id": "GoogleCloudApigeeV1CreditAppGroupBalanceRequest" }, "GoogleCloudApigeeV1ListDeveloperSubscriptionsResponse": { "description": "Response for ListDeveloperSubscriptions.", "type": "object", "properties": { "developerSubscriptions": { "description": "List of all subscriptions.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1DeveloperSubscription" } }, "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" } }, "id": "GoogleCloudApigeeV1ListDeveloperSubscriptionsResponse" }, "GoogleCloudApigeeV1SecurityActionHttpHeader": { "id": "GoogleCloudApigeeV1SecurityActionHttpHeader", "type": "object", "properties": { "name": { "type": "string", "description": "The header name to be sent to the target." }, "value": { "description": "The header value to be sent to the target.", "type": "string" } }, "description": "An HTTP header." }, "GoogleCloudApigeeV1EnvironmentClientIPResolutionConfig": { "description": "Configuration for resolving the client ip.", "type": "object", "properties": { "headerIndexAlgorithm": { "description": "Resolves the client ip based on a custom header.", "$ref": "GoogleCloudApigeeV1EnvironmentClientIPResolutionConfigHeaderIndexAlgorithm" } }, "id": "GoogleCloudApigeeV1EnvironmentClientIPResolutionConfig" }, "GoogleCloudApigeeV1ListSecurityProfilesResponse": { "id": "GoogleCloudApigeeV1ListSecurityProfilesResponse", "type": "object", "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." } }, "description": "Response for ListSecurityProfiles." }, "GoogleCloudApigeeV1Export": { "id": "GoogleCloudApigeeV1Export", "type": "object", "properties": { "executionTime": { "readOnly": true, "type": "string", "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." }, "description": { "type": "string", "description": "Description of the export job." }, "created": { "description": "Output only. Time the export job was created.", "type": "string", "readOnly": true }, "error": { "type": "string", "description": "Output only. Error is set when export fails", "readOnly": true }, "name": { "description": "Display name of the export job.", "type": "string" }, "updated": { "readOnly": true, "description": "Output only. Time the export job was last updated.", "type": "string" }, "state": { "readOnly": true, "type": "string", "description": "Output only. Status of the export job. Valid values include `enqueued`, `running`, `completed`, and `failed`." }, "datastoreName": { "description": "Name of the datastore that is the destination of the export job [datastore]", "type": "string" }, "self": { "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", "readOnly": true } }, "description": "Details of an export job." }, "GoogleCloudApigeeV1SecurityActionAllow": { "description": "Message that should be set in case of an Allow Action. This does not have any fields.", "type": "object", "properties": {}, "id": "GoogleCloudApigeeV1SecurityActionAllow" }, "GoogleCloudApigeeV1ListAsyncQueriesResponse": { "description": "The response for ListAsyncQueries.", "type": "object", "properties": { "queries": { "items": { "$ref": "GoogleCloudApigeeV1AsyncQuery" }, "type": "array", "description": "The asynchronous queries belong to requested resource name." } }, "id": "GoogleCloudApigeeV1ListAsyncQueriesResponse" }, "GoogleLongrunningOperation": { "id": "GoogleLongrunningOperation", "description": "This resource represents a long-running operation that is the result of a network API call.", "type": "object", "properties": { "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." }, "error": { "description": "The error result of the operation in case of failure or cancellation.", "$ref": "GoogleRpcStatus" }, "response": { "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`.", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." } }, "metadata": { "type": "object", "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.", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." } }, "name": { "type": "string", "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}`." } } }, "GoogleCloudApigeeV1AdjustDeveloperBalanceRequest": { "type": "object", "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. NOTE: An adjustment cannot increase the balance of the developer beyond the balance as of the most recent credit. For example, if a developer's balance is updated to be $100, and they spend $10, a negative adjustment can only increase the balance of the developer to $100.", "$ref": "GoogleTypeMoney" } }, "description": "Request for AdjustDeveloperBalance.", "id": "GoogleCloudApigeeV1AdjustDeveloperBalanceRequest" }, "GoogleCloudApigeeV1OrganizationProjectMapping": { "id": "GoogleCloudApigeeV1OrganizationProjectMapping", "type": "object", "properties": { "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": { "type": "string", "description": "Name of the Apigee organization." }, "projectId": { "type": "string", "description": "Google Cloud project associated with the Apigee organization" }, "projectIds": { "type": "array", "description": "DEPRECATED: Use `project_id`. An Apigee Organization is mapped to a single project.", "deprecated": true, "items": { "type": "string" } } } }, "GoogleCloudApigeeV1ListExportsResponse": { "description": "The response for ListExports", "type": "object", "properties": { "exports": { "type": "array", "description": "Details of the export jobs.", "items": { "$ref": "GoogleCloudApigeeV1Export" } } }, "id": "GoogleCloudApigeeV1ListExportsResponse" }, "GoogleCloudApigeeV1Datastore": { "id": "GoogleCloudApigeeV1Datastore", "type": "object", "properties": { "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", "type": "string", "readOnly": true, "format": "int64" }, "self": { "type": "string", "description": "Output only. Resource link of Datastore. Example: `/organizations/{org}/analytics/datastores/{uuid}`", "readOnly": true }, "datastoreConfig": { "description": "Datastore Configurations.", "$ref": "GoogleCloudApigeeV1DatastoreConfig" }, "displayName": { "type": "string", "description": "Required. Display name in UI" }, "org": { "readOnly": true, "type": "string", "description": "Output only. Organization that the datastore belongs to" }, "createTime": { "readOnly": true, "format": "int64", "description": "Output only. Datastore create time, in milliseconds since the epoch of 1970-01-01T00:00:00Z", "type": "string" } }, "description": "The data store defines the connection to export data repository (Cloud Storage, BigQuery), including the credentials used to access the data repository." }, "GoogleCloudApigeeV1Subscription": { "id": "GoogleCloudApigeeV1Subscription", "description": "Pub/Sub subscription of an environment.", "type": "object", "properties": { "name": { "description": "Full name of the Pub/Sub subcription. Use the following structure in your request: `subscription \"projects/foo/subscription/bar\"`", "type": "string" } } }, "GoogleCloudApigeeV1ListCustomReportsResponse": { "description": "This message encapsulates a list of custom report definitions", "type": "object", "properties": { "qualifier": { "type": "array", "items": { "$ref": "GoogleCloudApigeeV1CustomReport" } } }, "id": "GoogleCloudApigeeV1ListCustomReportsResponse" }, "GoogleCloudApigeeV1Space": { "type": "object", "properties": { "createTime": { "readOnly": true, "format": "google-datetime", "type": "string", "description": "Output only. Create timestamp of the space." }, "displayName": { "type": "string", "description": "Optional. Display name of the space." }, "name": { "description": "Output only. Identifier. Id of the space. This field is used as the resource name, and must follow [AIP-122](https://google.aip.dev/122) guidelines.", "type": "string", "readOnly": true }, "updateTime": { "type": "string", "description": "Output only. Last modified timestamp of the space.", "readOnly": true, "format": "google-datetime" } }, "description": "Organization space resource.", "id": "GoogleCloudApigeeV1Space" }, "GoogleCloudApigeeV1CanaryEvaluation": { "id": "GoogleCloudApigeeV1CanaryEvaluation", "description": "CanaryEvaluation represents the canary analysis between two versions of the runtime that is serving requests.", "type": "object", "properties": { "startTime": { "format": "google-datetime", "type": "string", "description": "Required. Start time for the canary evaluation's analysis." }, "endTime": { "description": "Required. End time for the evaluation's analysis.", "type": "string", "format": "google-datetime" }, "treatment": { "description": "Required. The newer version that is serving requests.", "type": "string" }, "metricLabels": { "description": "Required. Labels used to filter the metrics used for a canary evaluation.", "$ref": "GoogleCloudApigeeV1CanaryEvaluationMetricLabels" }, "createTime": { "type": "string", "description": "Output only. Create time of the canary evaluation.", "readOnly": true, "format": "google-datetime" }, "verdict": { "enumDescriptions": [ "Verdict is not available yet.", "No verdict reached.", "Evaluation is not good.", "Evaluation is good." ], "description": "Output only. The resulting verdict of the canary evaluations: NONE, PASS, or FAIL.", "readOnly": true, "enum": [ "VERDICT_UNSPECIFIED", "NONE", "FAIL", "PASS" ], "type": "string" }, "control": { "description": "Required. The stable version that is serving requests.", "type": "string" }, "state": { "enumDescriptions": [ "No state has been specified.", "The canary evaluation is still in progress.", "The canary evaluation has finished." ], "description": "Output only. The current state of the canary evaluation.", "readOnly": true, "enum": [ "STATE_UNSPECIFIED", "RUNNING", "SUCCEEDED" ], "type": "string" }, "name": { "readOnly": true, "type": "string", "description": "Output only. Name of the canary evalution." } } }, "GoogleLongrunningListOperationsResponse": { "description": "The response message for Operations.ListOperations.", "type": "object", "properties": { "unreachable": { "description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections. For example, when attempting to list all resources across all supported locations.", "type": "array", "items": { "type": "string" } }, "nextPageToken": { "description": "The standard List next-page token.", "type": "string" }, "operations": { "description": "A list of operations that matches the specified filter in the request.", "type": "array", "items": { "$ref": "GoogleLongrunningOperation" } } }, "id": "GoogleLongrunningListOperationsResponse" }, "GoogleCloudApigeeV1ListEnvironmentGroupAttachmentsResponse": { "id": "GoogleCloudApigeeV1ListEnvironmentGroupAttachmentsResponse", "description": "Response for ListEnvironmentGroupAttachments.", "type": "object", "properties": { "environmentGroupAttachments": { "type": "array", "description": "EnvironmentGroupAttachments for the specified environment group.", "items": { "$ref": "GoogleCloudApigeeV1EnvironmentGroupAttachment" } }, "nextPageToken": { "description": "Page token that you can include in a ListEnvironmentGroupAttachments request to retrieve the next page. If omitted, no subsequent pages exist.", "type": "string" } } }, "GoogleCloudApigeeV1ListEnvironmentGroupsResponse": { "id": "GoogleCloudApigeeV1ListEnvironmentGroupsResponse", "type": "object", "properties": { "environmentGroups": { "description": "EnvironmentGroups in the specified organization.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1EnvironmentGroup" } }, "nextPageToken": { "type": "string", "description": "Page token that you can include in a ListEnvironmentGroups request to retrieve the next page. If omitted, no subsequent pages exist." } }, "description": "Response for ListEnvironmentGroups." }, "GoogleCloudApigeeV1AppGroupBalance": { "id": "GoogleCloudApigeeV1AppGroupBalance", "description": "AppGroupBalance for the AppGroup.", "type": "object", "properties": { "wallets": { "readOnly": true, "items": { "$ref": "GoogleCloudApigeeV1AppGroupBalanceWallet" }, "description": "Output only. List of all wallets. Each individual wallet stores the account balance for a particular currency.", "type": "array" } } }, "GoogleCloudApigeeV1QueryTabularStatsRequest": { "id": "GoogleCloudApigeeV1QueryTabularStatsRequest", "type": "object", "properties": { "timeRange": { "description": "Time range for the stats.", "$ref": "GoogleTypeInterval" }, "pageSize": { "format": "int32", "type": "integer", "description": "Page size represents the number of rows." }, "dimensions": { "description": "Required. List of dimension names to group the aggregations by.", "type": "array", "items": { "type": "string" } }, "metrics": { "type": "array", "description": "Required. List of metrics and their aggregations.", "items": { "$ref": "GoogleCloudApigeeV1MetricAggregation" } }, "filter": { "type": "string", "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" }, "pageToken": { "type": "string", "description": "Identifies a sequence of rows." } }, "description": "Request payload representing the query to be run for fetching security statistics as rows." }, "GoogleCloudApigeeV1TlsInfoConfig": { "id": "GoogleCloudApigeeV1TlsInfoConfig", "type": "object", "properties": { "clientAuthEnabled": { "description": "Flag that specifies whether client-side authentication is enabled for the target server. Enables two-way TLS.", "type": "boolean" }, "enforce": { "type": "boolean", "description": "Flag that enforces TLS settings" }, "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}`" }, "keyAliasReference": { "description": "Reference name and alias pair to use for client-side authentication.", "$ref": "GoogleCloudApigeeV1KeyAliasReference" }, "enabled": { "description": "Flag that specifies whether one-way TLS is enabled. Set to `true` to enable one-way TLS.", "type": "boolean" }, "commonName": { "description": "Common name to validate the target server against.", "$ref": "GoogleCloudApigeeV1CommonNameConfig" }, "ignoreValidationErrors": { "type": "boolean", "description": "Flag that specifies whether to ignore TLS certificate validation errors. Set to `true` to ignore errors." }, "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}`" }, "protocols": { "items": { "type": "string" }, "type": "array", "description": "List of TLS protocols that are granted access." }, "ciphers": { "items": { "type": "string" }, "type": "array", "description": "List of ciphers that are granted access." } } }, "GoogleCloudApigeeV1IntegrationConfig": { "description": "Configuration for the Integration add-on.", "type": "object", "properties": { "enabled": { "description": "Flag that specifies whether the Integration add-on is enabled.", "type": "boolean" } }, "id": "GoogleCloudApigeeV1IntegrationConfig" }, "GoogleCloudApigeeV1ScoreComponentRecommendationActionActionContext": { "type": "object", "properties": { "documentationLink": { "description": "Documentation link for the action.", "type": "string" } }, "description": "Action context are all the relevant details for the action.", "id": "GoogleCloudApigeeV1ScoreComponentRecommendationActionActionContext" }, "GoogleIamV1AuditLogConfig": { "id": "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.", "type": "object", "properties": { "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" ], "description": "The log type that this config enables.", "enum": [ "LOG_TYPE_UNSPECIFIED", "ADMIN_READ", "DATA_WRITE", "DATA_READ" ], "type": "string" }, "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." } } }, "GoogleCloudApigeeV1ApiProxyRevision": { "id": "GoogleCloudApigeeV1ApiProxyRevision", "description": "API proxy revision.", "type": "object", "properties": { "description": { "description": "Description of the API proxy revision.", "type": "string" }, "basepaths": { "items": { "type": "string" }, "type": "array", "description": "Base URL of the API proxy." }, "teams": { "description": "List of the teams included in the API proxy revision.", "type": "array", "items": { "type": "string" } }, "configurationVersion": { "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.", "$ref": "GoogleCloudApigeeV1ConfigVersion" }, "createdAt": { "format": "int64", "description": "Time that the API proxy revision was created in milliseconds since epoch.", "type": "string" }, "spec": { "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.", "type": "string" }, "policies": { "type": "array", "description": "List of policy names included in the API proxy revision..", "items": { "type": "string" } }, "type": { "description": "Type. Set to `Application`. Maintained for compatibility with the Apigee Edge API.", "type": "string" }, "targetEndpoints": { "items": { "type": "string" }, "type": "array", "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." }, "proxyEndpoints": { "items": { "type": "string" }, "type": "array", "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." }, "integrationEndpoints": { "items": { "type": "string" }, "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.", "type": "array" }, "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" } }, "proxies": { "type": "array", "description": "List of proxy names included in the API proxy revision.", "items": { "type": "string" } }, "displayName": { "type": "string", "description": "Human-readable name of the API proxy." }, "name": { "type": "string", "description": "Name of the API proxy." }, "resources": { "description": "List of the resources included in the API proxy revision formatted as \"{type}://{name}\".", "type": "array", "items": { "type": "string" } }, "entityMetaDataAsProperties": { "description": "Metadata describing the API proxy revision as a key-value map.", "additionalProperties": { "type": "string" }, "type": "object" }, "revision": { "type": "string", "description": "API proxy revision." }, "contextInfo": { "description": "Revision number, app name, and organization for the API proxy.", "type": "string" }, "hasExtensiblePolicy": { "readOnly": true, "type": "boolean", "description": "Output only. This field will be marked as true if revision contains any policies marked as extensible." }, "targets": { "items": { "type": "string" }, "description": "List of the targets included in the API proxy revision.", "type": "array" }, "resourceFiles": { "description": "List of resource files included in the API proxy revision.", "$ref": "GoogleCloudApigeeV1ResourceFiles" }, "sharedFlows": { "type": "array", "description": "List of the shared flows included in the API proxy revision.", "items": { "type": "string" } }, "lastModifiedAt": { "format": "int64", "description": "Time that the API proxy revision was last modified in milliseconds since epoch.", "type": "string" }, "archive": { "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/*`", "type": "string", "readOnly": true } } }, "GoogleCloudApigeeV1SchemaSchemaProperty": { "description": "Properties for the schema field.", "type": "object", "properties": { "custom": { "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": "string" }, "type": { "description": "Data type of the field.", "type": "string" }, "createTime": { "description": "Time the field was created in RFC3339 string form. For example: `2016-02-26T10:23:09.592Z`.", "type": "string" } }, "id": "GoogleCloudApigeeV1SchemaSchemaProperty" }, "GoogleCloudApigeeV1CertInfo": { "id": "GoogleCloudApigeeV1CertInfo", "description": "X.509 certificate as defined in RFC 5280.", "type": "object", "properties": { "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." }, "sigAlgName": { "description": "X.509 signatureAlgorithm.", "type": "string" }, "expiryDate": { "type": "string", "description": "X.509 `notAfter` validity period in milliseconds since epoch.", "format": "int64" }, "validFrom": { "format": "int64", "type": "string", "description": "X.509 `notBefore` validity period in milliseconds since epoch." }, "subjectAlternativeNames": { "type": "array", "description": "X.509 subject alternative names (SANs) extension.", "items": { "type": "string" } }, "subject": { "type": "string", "description": "X.509 subject." }, "publicKey": { "description": "Public key component of the X.509 subject public key info.", "type": "string" }, "version": { "description": "X.509 version.", "type": "integer", "format": "int32" }, "issuer": { "type": "string", "description": "X.509 issuer." }, "basicConstraints": { "type": "string", "description": "X.509 basic constraints extension." } } }, "GoogleCloudApigeeV1KeyAliasReference": { "id": "GoogleCloudApigeeV1KeyAliasReference", "type": "object", "properties": { "reference": { "type": "string", "description": "Reference name in the following format: `organizations/{org}/environments/{env}/references/{reference}`" }, "aliasId": { "description": "Alias ID. Must exist in the keystore referred to by the reference.", "type": "string" } } }, "GoogleCloudApigeeV1KeyValueEntry": { "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.", "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." } } }, "GoogleCloudApigeeV1ListApiDocsResponse": { "id": "GoogleCloudApigeeV1ListApiDocsResponse", "type": "object", "properties": { "status": { "type": "string", "description": "Status of the operation." }, "message": { "type": "string", "description": "Description of the operation." }, "errorCode": { "description": "Unique error code for the request, if any.", "type": "string" }, "requestId": { "description": "Unique ID of the request.", "type": "string" }, "nextPageToken": { "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.", "type": "string" }, "data": { "items": { "$ref": "GoogleCloudApigeeV1ApiDoc" }, "type": "array", "description": "The catalog item resources." } } }, "GoogleCloudApigeeV1DateRange": { "type": "object", "properties": { "start": { "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.", "type": "string" }, "end": { "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.", "type": "string" } }, "description": "Date range of the data to export.", "id": "GoogleCloudApigeeV1DateRange" }, "GoogleCloudApigeeV1SecurityReportResultMetadata": { "description": "Contains informations about the security report results.", "type": "object", "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\"", "type": "string", "readOnly": true }, "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`" } }, "id": "GoogleCloudApigeeV1SecurityReportResultMetadata" }, "GoogleCloudApigeeV1KeyValueMap": { "type": "object", "properties": { "maskedValues": { "description": "Optional. Flag that specifies whether entry values will be masked when returned.", "type": "boolean" }, "name": { "description": "Required. ID of the key value map.", "type": "string" }, "encrypted": { "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.", "type": "boolean" } }, "description": "Collection of key/value string pairs.", "id": "GoogleCloudApigeeV1KeyValueMap" }, "GoogleCloudApigeeV1KeystoreConfig": { "id": "GoogleCloudApigeeV1KeystoreConfig", "type": "object", "properties": { "name": { "type": "string", "description": "Resource name in the following format: `organizations/{org}/environments/{env}/keystores/{keystore}`" }, "aliases": { "items": { "$ref": "GoogleCloudApigeeV1AliasRevisionConfig" }, "type": "array", "description": "Aliases in the keystore." } } }, "GoogleCloudApigeeV1SecurityAssessmentResultScoringResultAssessmentRecommendation": { "id": "GoogleCloudApigeeV1SecurityAssessmentResultScoringResultAssessmentRecommendation", "description": "The message format of a recommendation from the assessment.", "type": "object", "properties": { "recommendations": { "type": "array", "description": "The recommended steps of the assessment.", "items": { "$ref": "GoogleCloudApigeeV1SecurityAssessmentResultScoringResultAssessmentRecommendationRecommendation" } }, "weight": { "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.", "enum": [ "WEIGHT_UNSPECIFIED", "MINOR", "MODERATE", "MAJOR" ], "type": "string" }, "verdict": { "type": "string", "description": "Verdict indicates the assessment result.", "enum": [ "VERDICT_UNSPECIFIED", "PASS", "FAIL", "NOT_APPLICABLE" ], "enumDescriptions": [ "The verdict is unspecified.", "The assessment has passed.", "The assessment has failed.", "The verdict is not applicable." ] }, "displayName": { "description": "The display name of the assessment.", "type": "string" }, "scoreImpact": { "description": "Score impact indicates the impact on the overall score if the assessment were to pass.", "type": "integer", "format": "int32" } } }, "GoogleCloudApigeeV1Properties": { "id": "GoogleCloudApigeeV1Properties", "description": "Message for compatibility with legacy Edge specification for Java Properties object in JSON.", "type": "object", "properties": { "property": { "items": { "$ref": "GoogleCloudApigeeV1Property" }, "type": "array", "description": "List of all properties in the object" } } }, "GoogleCloudApigeeV1GrpcOperationGroup": { "description": "List of gRPC operation configuration details associated with Apigee API proxies.", "type": "object", "properties": { "operationConfigs": { "type": "array", "description": "Required. List of operation configurations for either Apigee API proxies that are associated with this API product.", "items": { "$ref": "GoogleCloudApigeeV1GrpcOperationConfig" } } }, "id": "GoogleCloudApigeeV1GrpcOperationGroup" }, "GoogleCloudApigeeV1AccessRemove": { "id": "GoogleCloudApigeeV1AccessRemove", "type": "object", "properties": { "success": { "type": "boolean" }, "name": { "type": "string" } }, "description": "Remove action. For example, \"Remove\" : { \"name\" : \"target.name\", \"success\" : true }" }, "GoogleCloudApigeeV1SharedFlow": { "type": "object", "properties": { "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" } }, "metaData": { "description": "Metadata describing the shared flow.", "$ref": "GoogleCloudApigeeV1EntityMetadata" }, "space": { "description": "Optional. The ID of the space associated with this shared flow. Any IAM policies applied to the space will control access to this shared flow. To learn how Spaces can be used to manage resources, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).", "type": "string" }, "name": { "description": "The ID of the shared flow.", "type": "string" } }, "description": "The metadata describing a shared flow", "id": "GoogleCloudApigeeV1SharedFlow" }, "GoogleCloudApigeeV1BatchUpdateSecurityIncidentsRequest": { "description": "Request for BatchUpdateSecurityIncident.", "type": "object", "properties": { "requests": { "items": { "$ref": "GoogleCloudApigeeV1UpdateSecurityIncidentRequest" }, "type": "array", "description": "Optional. Required. The request message specifying the resources to update. A maximum of 1000 can be modified in a batch." } }, "id": "GoogleCloudApigeeV1BatchUpdateSecurityIncidentsRequest" }, "GoogleCloudApigeeV1BatchUpdateSecurityIncidentsResponse": { "type": "object", "properties": { "securityIncidents": { "type": "array", "description": "Output only. Updated security incidents", "readOnly": true, "items": { "$ref": "GoogleCloudApigeeV1SecurityIncident" } } }, "description": "Response for BatchUpdateSecurityIncident.", "id": "GoogleCloudApigeeV1BatchUpdateSecurityIncidentsResponse" }, "GoogleCloudApigeeV1GetAsyncQueryResultUrlResponse": { "type": "object", "properties": { "urls": { "items": { "$ref": "GoogleCloudApigeeV1GetAsyncQueryResultUrlResponseURLInfo" }, "description": "The list of Signed URLs generated by the CreateAsyncQuery request", "type": "array" } }, "description": "The response for GetAsyncQueryResultUrl", "id": "GoogleCloudApigeeV1GetAsyncQueryResultUrlResponse" }, "GoogleCloudApigeeV1MoveApiProductRequest": { "id": "GoogleCloudApigeeV1MoveApiProductRequest", "type": "object", "properties": { "space": { "type": "string", "description": "Optional. Resource ID of the space to move the API product to. If unspecified, the API product will be moved to the organization level." } }, "description": "Moves API product to a different space." }, "GoogleCloudApigeeV1TargetServer": { "type": "object", "properties": { "description": { "description": "Optional. A human-readable description of this TargetServer.", "type": "string" }, "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." }, "sSLInfo": { "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.", "$ref": "GoogleCloudApigeeV1TlsInfo" }, "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", "description": "Immutable. The protocol used by this TargetServer.", "enum": [ "PROTOCOL_UNSPECIFIED", "HTTP", "HTTP2", "GRPC_TARGET", "GRPC", "EXTERNAL_CALLOUT" ] }, "name": { "type": "string", "description": "Required. The resource id of this target server. Values must match the regular expression " }, "port": { "description": "Required. The port number this target connects to on the given host. Value must be between 1 and 65535, inclusive.", "type": "integer", "format": "int32" }, "host": { "description": "Required. The host name this target connects to. Value must be a valid hostname as described by RFC-1123.", "type": "string" } }, "description": "TargetServer configuration. TargetServers are used to decouple a proxy TargetEndpoint HTTPTargetConnections from concrete URLs for backend services.", "id": "GoogleCloudApigeeV1TargetServer" }, "GoogleIamV1SetIamPolicyRequest": { "description": "Request message for `SetIamPolicy` method.", "type": "object", "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" } }, "id": "GoogleIamV1SetIamPolicyRequest" }, "GoogleCloudApigeeV1SecurityIncident": { "id": "GoogleCloudApigeeV1SecurityIncident", "description": "Represents an SecurityIncident resource.", "type": "object", "properties": { "observability": { "type": "string", "description": "Optional. Indicates if the user archived this incident.", "enum": [ "OBSERVABILITY_UNSPECIFIED", "ACTIVE", "ARCHIVED" ], "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." ] }, "lastDetectedTime": { "type": "string", "description": "Output only. The time when events associated with the incident were last detected.", "readOnly": true, "format": "google-datetime" }, "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" } }, "name": { "type": "string", "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" }, "displayName": { "description": "Optional. Display name of the security incident.", "type": "string" }, "riskLevel": { "readOnly": true, "type": "string", "enum": [ "RISK_LEVEL_UNSPECIFIED", "LOW", "MODERATE", "SEVERE" ], "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." }, "firstDetectedTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. The time when events associated with the incident were first detected.", "type": "string" }, "lastObservabilityChangeTime": { "readOnly": true, "format": "google-datetime", "type": "string", "description": "Output only. The time when the incident observability was last changed." }, "trafficCount": { "type": "string", "description": "Total traffic detected as part of the incident.", "format": "int64" } } }, "GoogleCloudApigeeV1SecurityAssessmentResultResource": { "id": "GoogleCloudApigeeV1SecurityAssessmentResultResource", "description": "Resource for which we are computing security assessment.", "type": "object", "properties": { "apiHubDeploymentDetails": { "description": "Output only. Additional details for the API Hub deployment.", "readOnly": true, "$ref": "GoogleCloudApigeeV1SecurityAssessmentResultResourceApiHubDeploymentDetails" }, "type": { "enumDescriptions": [ "ResourceType not specified.", "Resource is an Apigee Proxy.", "Resource is an API Hub deployment." ], "description": "Required. Type of this resource.", "enum": [ "RESOURCE_TYPE_UNSPECIFIED", "API_PROXY", "API_HUB_DEPLOYMENT" ], "type": "string" }, "apiHubGatewayType": { "enumDescriptions": [ "Gateway type is not specified.", "Gateway is Apigee X for API Hub.", "Gateway is Apigee Hybrid for API Hub.", "Gateway is Apigee Edge for API Hub.", "Gateway is Apigee OPDK for API Hub." ], "description": "Optional. ", "enum": [ "API_HUB_GATEWAY_TYPE_UNSPECIFIED", "APIGEE_X", "APIGEE_HYBRID", "APIGEE_EDGE", "APIGEE_OPDK" ], "type": "string" }, "name": { "type": "string", "description": "Required. Name of this resource. For an Apigee API Proxy, this should be the id of the API proxy. For an API Hub Deployment, this should be the id of the deployment." }, "resourceRevisionId": { "type": "string", "description": "The revision id for the resource. In case of Apigee, this is proxy revision id." } } }, "GoogleCloudApigeeV1ApiProxy": { "type": "object", "properties": { "name": { "description": "Output only. Name of the API proxy.", "type": "string", "readOnly": true }, "apiProxyType": { "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": "Output only. The type of the API proxy.", "readOnly": true, "enum": [ "API_PROXY_TYPE_UNSPECIFIED", "PROGRAMMABLE", "CONFIGURABLE" ], "type": "string" }, "labels": { "description": "User labels applied to this API Proxy.", "additionalProperties": { "type": "string" }, "type": "object" }, "space": { "type": "string", "description": "Optional. The id of the space this proxy is associated with. Any IAM policies applied to the space will control access to this proxy. To learn how Spaces can be used to manage resources, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview)." }, "metaData": { "description": "Output only. Metadata describing the API proxy.", "readOnly": true, "$ref": "GoogleCloudApigeeV1EntityMetadata" }, "revision": { "readOnly": true, "items": { "type": "string" }, "description": "Output only. List of revisions defined for the API proxy.", "type": "array" }, "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.", "type": "boolean", "readOnly": true }, "latestRevisionId": { "type": "string", "description": "Output only. The id of the most recently created revision for this api proxy.", "readOnly": true } }, "description": "Metadata describing the API proxy", "id": "GoogleCloudApigeeV1ApiProxy" }, "GoogleCloudApigeeV1EnvironmentConfig": { "id": "GoogleCloudApigeeV1EnvironmentConfig", "type": "object", "properties": { "targets": { "items": { "$ref": "GoogleCloudApigeeV1TargetServerConfig" }, "description": "List of target servers in the environment. Disabled target servers are not displayed.", "type": "array" }, "revisionId": { "format": "int64", "type": "string", "description": "Revision ID of the environment configuration. The higher the value, the more recently the configuration was deployed." }, "flowhooks": { "type": "array", "description": "List of flow hooks in the environment.", "items": { "$ref": "GoogleCloudApigeeV1FlowHookConfig" } }, "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." }, "featureFlags": { "type": "object", "description": "Feature flags inherited from the organization and environment.", "additionalProperties": { "type": "string" } }, "traceConfig": { "description": "Trace configurations. Contains config for the environment and config overrides for specific API proxies.", "$ref": "GoogleCloudApigeeV1RuntimeTraceConfig" }, "deploymentGroups": { "type": "array", "description": "List of deployment groups in the environment.", "items": { "$ref": "GoogleCloudApigeeV1DeploymentGroupConfig" } }, "keystores": { "type": "array", "description": "List of keystores in the environment.", "items": { "$ref": "GoogleCloudApigeeV1KeystoreConfig" } }, "addonsConfig": { "description": "The latest runtime configurations for add-ons.", "$ref": "GoogleCloudApigeeV1RuntimeAddonsConfig" }, "deployments": { "items": { "$ref": "GoogleCloudApigeeV1DeploymentConfig" }, "description": "List of deployments in the environment.", "type": "array" }, "gatewayConfigLocation": { "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.", "type": "string" }, "forwardProxyUri": { "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.", "type": "string" }, "sequenceNumber": { "type": "string", "description": "DEPRECATED: Use revision_id.", "format": "int64" }, "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." }, "resourceReferences": { "items": { "$ref": "GoogleCloudApigeeV1ReferenceConfig" }, "description": "List of resource references in the environment.", "type": "array" }, "debugMask": { "description": "Debug mask that applies to all deployments in the environment.", "$ref": "GoogleCloudApigeeV1DebugMask" }, "pubsubTopic": { "type": "string", "description": "Name of the PubSub topic for the environment." }, "createTime": { "type": "string", "description": "Time that the environment configuration was created.", "format": "google-datetime" }, "uid": { "description": "Unique ID for the environment configuration. The ID will only change if the environment is deleted and recreated.", "type": "string" }, "arcConfigLocation": { "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.", "type": "string" }, "name": { "type": "string", "description": "Name of the environment configuration in the following format: `organizations/{org}/environments/{env}/configs/{config}`" }, "resources": { "description": "List of resource versions in the environment.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1ResourceConfig" } }, "dataCollectors": { "type": "array", "description": "List of data collectors used by the deployments in the environment.", "items": { "$ref": "GoogleCloudApigeeV1DataCollectorConfig" } }, "clientIpResolutionConfig": { "description": "The algorithm to resolve IP.", "$ref": "GoogleCloudApigeeV1EnvironmentConfigClientIPResolutionConfig" } } }, "GoogleCloudApigeeV1SecurityAssessmentResultScoringResult": { "type": "object", "properties": { "severity": { "type": "string", "enum": [ "SEVERITY_UNSPECIFIED", "LOW", "MEDIUM", "HIGH", "MINIMAL" ], "enumDescriptions": [ "Severity is not defined.", "Severity is low.", "Severity is medium.", "Severity is high.", "Severity is minimal" ] }, "failedAssessmentPerWeight": { "type": "object", "description": "The number of failed assessments grouped by its weight. Keys are one of the following: \"MAJOR\", \"MODERATE\", \"MINOR\".", "additionalProperties": { "type": "integer", "format": "int32" } }, "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", "type": "string", "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." }, "score": { "type": "integer", "description": "The security score of the assessment.", "format": "int32" } }, "description": "The result of the assessment.", "id": "GoogleCloudApigeeV1SecurityAssessmentResultScoringResult" }, "GoogleIamV1TestIamPermissionsResponse": { "id": "GoogleIamV1TestIamPermissionsResponse", "description": "Response message for `TestIamPermissions` method.", "type": "object", "properties": { "permissions": { "type": "array", "description": "A subset of `TestPermissionsRequest.permissions` that the caller is allowed.", "items": { "type": "string" } } } }, "GoogleCloudApigeeV1ListDataCollectorsResponse": { "description": "Response for ListDataCollectors.", "type": "object", "properties": { "dataCollectors": { "type": "array", "description": "Data collectors in the specified organization.", "items": { "$ref": "GoogleCloudApigeeV1DataCollector" } }, "nextPageToken": { "type": "string", "description": "Page token that you can include in a ListDataCollectors request to retrieve the next page. If omitted, no subsequent pages exist." } }, "id": "GoogleCloudApigeeV1ListDataCollectorsResponse" }, "GoogleCloudApigeeV1ScoreComponent": { "id": "GoogleCloudApigeeV1ScoreComponent", "description": "Component is an individual security element that is scored.", "type": "object", "properties": { "score": { "type": "integer", "description": "Score for the component.", "format": "int32" }, "calculateTime": { "type": "string", "description": "Time when score was calculated.", "format": "google-datetime" }, "drilldownPaths": { "items": { "type": "string" }, "description": "List of paths for next components.", "type": "array" }, "scorePath": { "type": "string", "description": "Path of the component. Example: /org@myorg/envgroup@myenvgroup/proxies/proxy@myproxy" }, "recommendations": { "items": { "$ref": "GoogleCloudApigeeV1ScoreComponentRecommendation" }, "type": "array", "description": "List of recommendations to improve API security." }, "dataCaptureTime": { "type": "string", "description": "Time in the requested time period when data was last captured to compute the score.", "format": "google-datetime" } } }, "GoogleCloudApigeeV1ApiDebugSession": { "type": "object", "properties": { "environmentId": { "type": "string", "description": "The environment ID of the deployed API proxy." }, "createTime": { "format": "google-datetime", "type": "string", "description": "The first transaction creation timestamp in millisecond, recorded by UAP." }, "apiProxyRevisionId": { "type": "string", "description": "The revision ID of the deployed API proxy." }, "id": { "description": "The debug session ID.", "type": "string" } }, "description": "Session carries the debug session id and its creation time.", "id": "GoogleCloudApigeeV1ApiDebugSession" }, "GoogleCloudApigeeV1SyncAuthorization": { "id": "GoogleCloudApigeeV1SyncAuthorization", "type": "object", "properties": { "identities": { "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", "items": { "type": "string" } }, "etag": { "format": "byte", "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.", "type": "string" } } }, "GoogleCloudApigeeV1SecurityReportQuery": { "id": "GoogleCloudApigeeV1SecurityReportQuery", "description": "Body structure when user makes a request to create a security report.", "type": "object", "properties": { "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\" }" }, "displayName": { "type": "string", "description": "Security Report display name which users can specify." }, "limit": { "format": "int32", "type": "integer", "description": "Maximum number of rows that can be returned in the result." }, "reportDefinitionId": { "description": "Report Definition ID.", "type": "string" }, "envgroupHostname": { "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.", "type": "string" }, "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" }, "dimensions": { "type": "array", "description": "A list of dimensions. https://docs.apigee.com/api-platform/analytics/analytics-reference#dimensions", "items": { "type": "string" } }, "mimeType": { "type": "string", "description": "Valid values include: `csv` or `json`. Defaults to `json`. Note: Configure the delimiter for CSV output using the csvDelimiter property." }, "metrics": { "type": "array", "description": "A list of Metrics.", "items": { "$ref": "GoogleCloudApigeeV1SecurityReportQueryMetric" } }, "filter": { "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", "type": "string" }, "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`)." } } }, "GoogleTypeMoney": { "id": "GoogleTypeMoney", "description": "Represents an amount of money with its currency type.", "type": "object", "properties": { "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." }, "units": { "description": "The whole units of the amount. For example if `currencyCode` is `\"USD\"`, then 1 unit is one US dollar.", "type": "string", "format": "int64" } } }, "GoogleCloudApigeeV1Credential": { "type": "object", "properties": { "status": { "type": "string", "description": "Status of the credential. Valid values include `approved` or `revoked`." }, "consumerKey": { "description": "Consumer key.", "type": "string" }, "expiresAt": { "format": "int64", "description": "Time the credential will expire in milliseconds since epoch.", "type": "string" }, "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" } }, "issuedAt": { "format": "int64", "type": "string", "description": "Time the credential was issued in milliseconds since epoch." }, "attributes": { "items": { "$ref": "GoogleCloudApigeeV1Attribute" }, "type": "array", "description": "List of attributes associated with this credential." }, "consumerSecret": { "description": "Secret key.", "type": "string" }, "apiProducts": { "description": "List of API products this credential can be used for.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1ApiProductRef" } } }, "id": "GoogleCloudApigeeV1Credential" }, "GoogleCloudApigeeV1FlowHook": { "type": "object", "properties": { "sharedFlow": { "type": "string", "description": "Shared flow attached to this flow hook, or empty if there is none attached." }, "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`." }, "flowHookPoint": { "type": "string", "description": "Output only. Where in the API call flow the flow hook is invoked. Must be one of `PreProxyFlowHook`, `PostProxyFlowHook`, `PreTargetFlowHook`, or `PostTargetFlowHook`.", "readOnly": true }, "description": { "type": "string", "description": "Description of the flow hook." } }, "id": "GoogleCloudApigeeV1FlowHook" }, "GoogleCloudApigeeV1RevisionStatus": { "id": "GoogleCloudApigeeV1RevisionStatus", "type": "object", "properties": { "revisionId": { "type": "string", "description": "The revision of the resource." }, "replicas": { "format": "int32", "description": "The number of replicas that have successfully loaded this revision.", "type": "integer" }, "errors": { "type": "array", "description": "Errors reported when attempting to load this revision.", "items": { "$ref": "GoogleCloudApigeeV1UpdateError" } }, "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." } }, "description": "The status of a specific resource revision." }, "GoogleCloudApigeeV1AppGroupMonetizationConfig": { "description": "Monetization configuration for the AppGroup.", "type": "object", "properties": { "billingType": { "type": "string", "description": "Required. Billing type.", "enum": [ "BILLING_TYPE_UNSPECIFIED", "PREPAID", "POSTPAID" ], "enumDescriptions": [ "The default/unset value.", "AppGroup pays in advance for the use of APIs and the charged amount is deducted from their account balance.", "AppGroup does not maintain an account balance. The API provider bills the AppGroup for API usage." ] } }, "id": "GoogleCloudApigeeV1AppGroupMonetizationConfig" }, "GoogleCloudApigeeV1ListEnvironmentResourcesResponse": { "id": "GoogleCloudApigeeV1ListEnvironmentResourcesResponse", "type": "object", "properties": { "resourceFile": { "items": { "$ref": "GoogleCloudApigeeV1ResourceFile" }, "type": "array", "description": "List of resources files." } }, "description": "Response for ListEnvironmentResources" }, "GoogleCloudApigeeV1GrpcOperationConfig": { "type": "object", "properties": { "attributes": { "items": { "$ref": "GoogleCloudApigeeV1Attribute" }, "description": "Custom attributes associated with the operation.", "type": "array" }, "methods": { "items": { "type": "string" }, "type": "array", "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\"]." }, "service": { "type": "string", "description": "Required. gRPC Service name associated to be associated with the API proxy, on which quota rules can be applied upon." }, "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" }, "apiSource": { "description": "Required. Name of the API proxy with which the gRPC operation and quota are associated.", "type": "string" } }, "description": "Binds the resources in a proxy or remote service with the gRPC operation and its associated quota enforcement.", "id": "GoogleCloudApigeeV1GrpcOperationConfig" }, "GoogleCloudApigeeV1ListAppsResponse": { "id": "GoogleCloudApigeeV1ListAppsResponse", "type": "object", "properties": { "app": { "type": "array", "items": { "$ref": "GoogleCloudApigeeV1App" } }, "totalSize": { "type": "integer", "description": "Total count of Apps.", "format": "int32" }, "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" } } }, "GoogleCloudApigeeV1ListApiDebugSessionsResponse": { "type": "object", "properties": { "sessions": { "description": "Session info that includes debug session ID, environment ID, api proxy revision ID and the first transaction creation timestamp.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1ApiDebugSession" } }, "nextPageToken": { "description": "Page token that you can include in a ListApiDebugSessionsRequest to retrieve the next page. If omitted, no subsequent pages exist.", "type": "string" } }, "description": "Response for ListApiDebugSessions.", "id": "GoogleCloudApigeeV1ListApiDebugSessionsResponse" }, "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": { "type": "string", "enum": [ "ALIAS_TYPE_UNSPECIFIED", "CERT", "KEY_CERT" ], "enumDescriptions": [ "Alias type is not specified.", "Certificate.", "Key/certificate pair." ] }, "location": { "type": "string", "description": "Location of the alias file. For example, a Google Cloud Storage URI." } }, "id": "GoogleCloudApigeeV1AliasRevisionConfig" }, "GoogleCloudApigeeV1RuntimeTraceConfigOverride": { "description": "NEXT ID: 9 Trace configuration override for a specific API proxy in an environment.", "type": "object", "properties": { "traceProtocol": { "enumDescriptions": [ "Protocol unspecified. Defaults to OPEN_CENSUS.", "Uses OpenCensus protocol.", "Uses OpenTelemetry Protocol (OTLP)." ], "description": "Optional. The trace protocol to use.", "enum": [ "TRACE_PROTOCOL_UNSPECIFIED", "OPEN_CENSUS", "OTLP" ], "type": "string" }, "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." }, "revisionId": { "description": "Revision number which can be used by the runtime to detect if the trace config override has changed between two versions.", "type": "string" }, "name": { "type": "string", "description": "Name of the trace config override in the following format: `organizations/{org}/environment/{env}/traceConfig/overrides/{override}`" }, "revisionCreateTime": { "description": "The timestamp that the revision was created or updated.", "type": "string", "format": "google-datetime" }, "apiProxy": { "description": "Name of the API proxy that will have its trace configuration overridden following format: `organizations/{org}/apis/{api}`", "type": "string" }, "openTelemetryProtocolEnabled": { "type": "boolean", "description": "Optional. If `true`, the runtime uses OpenTelemetry Protocol (OTLP) to send trace data. Configuration Requirements (if `open_telemetry_protocol_enabled` is `true`): - Allowed `Exporter`s: `CLOUD_TRACE` or `OPEN_TELEMETRY_COLLECTOR`. - If `Exporter` is `OPEN_TELEMETRY_COLLECTOR`: - `endpoint` refers to a valid OTLP collector URL. - If `Exporter` is `CLOUD_TRACE`: - `endpoint` refers to a valid project ID Deprecated: Use trace_protocol instead.", "deprecated": true }, "samplingConfig": { "description": "Trace configuration override for a specific API proxy in an environment.", "$ref": "GoogleCloudApigeeV1RuntimeTraceSamplingConfig" } }, "id": "GoogleCloudApigeeV1RuntimeTraceConfigOverride" }, "GoogleCloudApigeeV1ApiDoc": { "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.", "type": "object", "properties": { "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." }, "published": { "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.", "type": "boolean" }, "description": { "description": "Optional. Description of the catalog item. Max length is 10,000 characters.", "type": "string" }, "graphqlEndpointUrl": { "type": "string", "description": "Optional. DEPRECATED: manage documentation through the `getDocumentation` and `updateDocumentation` methods", "deprecated": true }, "specId": { "description": "Optional. DEPRECATED: DO NOT USE", "type": "string", "deprecated": true }, "id": { "readOnly": true, "format": "int64", "type": "string", "description": "Output only. The ID of the catalog item." }, "graphqlSchema": { "description": "Optional. DEPRECATED: manage documentation through the `getDocumentation` and `updateDocumentation` methods", "type": "string", "deprecated": true }, "anonAllowed": { "type": "boolean", "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." }, "categoryIds": { "items": { "type": "string" }, "type": "array", "description": "Optional. The IDs of the API categories to which this catalog item belongs." }, "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." }, "siteId": { "description": "Output only. The ID of the parent portal.", "type": "string", "readOnly": true }, "title": { "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": "string" }, "edgeAPIProductName": { "description": "Optional. Immutable. DEPRECATED: use the `apiProductName` field instead", "type": "string" }, "graphqlSchemaDisplayName": { "deprecated": true, "description": "Optional. DEPRECATED: manage documentation through the `getDocumentation` and `updateDocumentation` methods", "type": "string" }, "visibility": { "type": "boolean", "description": "Optional. DEPRECATED: use the `published` field instead" }, "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" }, "modified": { "type": "string", "description": "Output only. Time the catalog item was last modified in milliseconds since epoch.", "readOnly": true, "format": "int64" } }, "id": "GoogleCloudApigeeV1ApiDoc" }, "GoogleCloudApigeeV1ApiDocDocumentationResponse": { "type": "object", "properties": { "data": { "$ref": "GoogleCloudApigeeV1ApiDocDocumentation", "readOnly": true, "description": "Output only. The documentation resource." }, "requestId": { "description": "Output only. Unique ID of the request.", "type": "string", "readOnly": true }, "status": { "description": "Output only. Status of the operation.", "type": "string", "readOnly": true }, "message": { "type": "string", "description": "Output only. Description of the operation.", "readOnly": true }, "errorCode": { "readOnly": true, "description": "Output only. Unique error code for the request, if any.", "type": "string" } }, "description": "The catalog item documentation wrapped with response status, error_code, etc.", "id": "GoogleCloudApigeeV1ApiDocDocumentationResponse" }, "GoogleCloudApigeeV1AdvancedApiOpsConfig": { "type": "object", "properties": { "enabled": { "description": "Flag that specifies whether the Advanced API Ops add-on is enabled.", "type": "boolean" } }, "description": "Configuration for the Advanced API Ops add-on.", "id": "GoogleCloudApigeeV1AdvancedApiOpsConfig" }, "GoogleCloudApigeeV1DeploymentChangeReportRoutingDeployment": { "id": "GoogleCloudApigeeV1DeploymentChangeReportRoutingDeployment", "description": "Tuple representing a base path and the deployment containing it.", "type": "object", "properties": { "basepath": { "type": "string", "description": "Base path receiving traffic." }, "environment": { "type": "string", "description": "Name of the environment in which the proxy is deployed." }, "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" } } }, "GoogleCloudApigeeV1RuntimeTraceConfig": { "id": "GoogleCloudApigeeV1RuntimeTraceConfig", "type": "object", "properties": { "overrides": { "type": "array", "description": "List of trace configuration overrides for spicific API proxies.", "items": { "$ref": "GoogleCloudApigeeV1RuntimeTraceConfigOverride" } }, "revisionId": { "description": "Revision number which can be used by the runtime to detect if the trace config has changed between two versions.", "type": "string" }, "traceProtocol": { "enumDescriptions": [ "Protocol unspecified. Defaults to OPEN_CENSUS.", "Uses OpenCensus protocol.", "Uses OpenTelemetry Protocol (OTLP)." ], "description": "Optional. The trace protocol to use.", "enum": [ "TRACE_PROTOCOL_UNSPECIFIED", "OPEN_CENSUS", "OTLP" ], "type": "string" }, "name": { "type": "string", "description": "Name of the trace config in the following format: `organizations/{org}/environment/{env}/traceConfig`" }, "revisionCreateTime": { "type": "string", "description": "The timestamp that the revision was created or updated.", "format": "google-datetime" }, "openTelemetryProtocolEnabled": { "deprecated": true, "description": "Optional. If `true`, the runtime uses OpenTelemetry Protocol (OTLP) to send trace data. Configuration Requirements (if `open_telemetry_protocol_enabled` is `true`): - Allowed `Exporter`s: `CLOUD_TRACE` or `OPEN_TELEMETRY_COLLECTOR`. - If `Exporter` is `OPEN_TELEMETRY_COLLECTOR`: - `endpoint` refers to a valid OTLP collector URL. - If `Exporter` is `CLOUD_TRACE`: - `endpoint` refers to a valid project ID Deprecated: Use trace_protocol instead.", "type": "boolean" }, "samplingConfig": { "description": "Trace configuration for all API proxies in an environment.", "$ref": "GoogleCloudApigeeV1RuntimeTraceSamplingConfig" }, "endpoint": { "description": "Endpoint of the exporter.", "type": "string" }, "exporter": { "enumDescriptions": [ "Exporter unspecified", "Exports events to Jaeger. Compatible with OpenCensus protocol.", "Exports events to Cloud Trace. Compatible with OpenCensus protocol.", "OpenTelemetry Collector. Compatible with OpenTelemetry protocol.", "Exports events to Cloud Trace. Compatible with OpenTelemetry protocol." ], "type": "string", "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.", "enum": [ "EXPORTER_UNSPECIFIED", "JAEGER", "CLOUD_TRACE", "OPEN_TELEMETRY_COLLECTOR", "OPEN_TELEMETRY_CLOUD_TRACE" ] } }, "description": "NEXT ID: 10 RuntimeTraceConfig defines the configurations for distributed trace in an environment." }, "GoogleCloudApigeeV1ApiCategory": { "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.", "type": "object", "properties": { "siteId": { "description": "Name of the portal.", "type": "string" }, "name": { "type": "string", "description": "Name of the category." }, "id": { "description": "ID of the category (a UUID).", "type": "string" }, "updateTime": { "format": "int64", "description": "Time the category was last modified in milliseconds since epoch.", "type": "string" } }, "id": "GoogleCloudApigeeV1ApiCategory" }, "GoogleCloudApigeeV1ResourceFiles": { "description": "List of resource files.", "type": "object", "properties": { "resourceFile": { "items": { "$ref": "GoogleCloudApigeeV1ResourceFile" }, "type": "array", "description": "List of resource files." } }, "id": "GoogleCloudApigeeV1ResourceFiles" }, "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestIncludeAll": { "id": "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestIncludeAll", "type": "object", "properties": {}, "description": "Message for include_all_resources option." }, "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." } } }, "GoogleCloudApigeeV1EnvironmentGroupConfig": { "id": "GoogleCloudApigeeV1EnvironmentGroupConfig", "description": "EnvironmentGroupConfig is a revisioned snapshot of an EnvironmentGroup and its associated routing rules.", "type": "object", "properties": { "hostnames": { "items": { "type": "string" }, "type": "array", "description": "Host names for the environment group." }, "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": { "format": "int64", "description": "Revision id that defines the ordering of the EnvironmentGroupConfig resource. The higher the revision, the more recently the configuration was deployed.", "type": "string" }, "name": { "description": "Name of the environment group in the following format: `organizations/{org}/envgroups/{envgroup}`.", "type": "string" }, "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" } }, "location": { "type": "string", "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." }, "endpointChainingRules": { "items": { "$ref": "GoogleCloudApigeeV1EndpointChainingRule" }, "type": "array", "description": "A list of proxies in each deployment group for proxy chaining calls." } } }, "GoogleCloudApigeeV1DeveloperApp": { "id": "GoogleCloudApigeeV1DeveloperApp", "type": "object", "properties": { "appId": { "type": "string", "description": "ID of the developer app. This ID is not user specified but is automatically generated on app creation. appId is a UUID." }, "attributes": { "items": { "$ref": "GoogleCloudApigeeV1Attribute" }, "description": "List of attributes for the developer app.", "type": "array" }, "credentials": { "description": "Output only. Set of credentials for the developer app consisting of the consumer key/secret pairs associated with the API products.", "type": "array", "readOnly": true, "items": { "$ref": "GoogleCloudApigeeV1Credential" } }, "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.", "type": "array", "items": { "type": "string" } }, "lastModifiedAt": { "type": "string", "description": "Output only. Time the developer app was modified in milliseconds since epoch.", "readOnly": true, "format": "int64" }, "developerId": { "type": "string", "description": "ID of the developer." }, "appFamily": { "type": "string", "description": "Developer app family." }, "apiProducts": { "items": { "type": "string" }, "description": "List of API products associated with the developer app.", "type": "array" }, "status": { "description": "Status of the credential. Valid values include `approved` or `revoked`.", "type": "string" }, "keyExpiresIn": { "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.", "type": "string", "format": "int64" }, "createdAt": { "readOnly": true, "format": "int64", "type": "string", "description": "Output only. Time the developer app was created in milliseconds since epoch." }, "callbackUrl": { "type": "string", "description": "Callback URL used by OAuth 2.0 authorization servers to communicate authorization codes back to developer apps." }, "name": { "description": "Name of the developer app.", "type": "string" } } }, "GoogleCloudApigeeV1Schema": { "id": "GoogleCloudApigeeV1Schema", "type": "object", "properties": { "metrics": { "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`.", "type": "array" }, "meta": { "items": { "type": "string" }, "description": "Additional metadata associated with schema. This is a legacy field and usually consists of an empty array of strings.", "type": "array" }, "dimensions": { "type": "array", "description": "List of schema fields grouped as dimensions.", "items": { "$ref": "GoogleCloudApigeeV1SchemaSchemaElement" } } }, "description": "Response for Schema call" }, "GoogleCloudApigeeV1AppGroup": { "type": "object", "properties": { "lastModifiedAt": { "type": "string", "description": "Output only. Modified time as milliseconds since epoch.", "readOnly": true, "format": "int64" }, "name": { "description": "Immutable. Name of the AppGroup. Characters you can use in the name are restricted to: A-Z0-9._\\-$ %.", "type": "string" }, "channelUri": { "description": "A reference to the associated storefront/marketplace.", "type": "string" }, "displayName": { "description": "app group name displayed in the UI", "type": "string" }, "appGroupId": { "description": "Output only. Internal identifier that cannot be edited", "type": "string", "readOnly": true }, "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" }, "email": { "type": "string", "description": "Optional. Email of the AppGroup." }, "createdAt": { "type": "string", "description": "Output only. Created time as milliseconds since epoch.", "readOnly": true, "format": "int64" }, "channelId": { "type": "string", "description": "channel identifier identifies the owner maintaing this grouping." }, "attributes": { "items": { "$ref": "GoogleCloudApigeeV1Attribute" }, "type": "array", "description": "A list of attributes" }, "organization": { "description": "Immutable. the org the app group is created", "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" }, "GoogleCloudApigeeV1UpdateError": { "id": "GoogleCloudApigeeV1UpdateError", "type": "object", "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." }, "type": { "description": "A string that uniquely identifies the type of error. This provides a more reliable means to deduplicate errors across revisions and instances.", "type": "string" }, "code": { "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": "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" ] }, "message": { "description": "User-friendly error message.", "type": "string" } }, "description": "Details on why a resource update failed in the runtime." }, "GoogleCloudApigeeV1AdjustAppGroupBalanceRequest": { "type": "object", "properties": { "adjustment": { "description": "Required. * A positive value of `adjustment` means that that the API provider wants to adjust the balance for an under-charged AppGroup i.e. the balance of the AppGroup will decrease. * A negative value of `adjustment` is not supported. Use credit balance API instead.", "$ref": "GoogleTypeMoney" } }, "description": "Request for AdjustAppGroupBalance.", "id": "GoogleCloudApigeeV1AdjustAppGroupBalanceRequest" }, "GoogleCloudApigeeV1ComputeEnvironmentScoresRequest": { "description": "Request for ComputeEnvironmentScores.", "type": "object", "properties": { "timeRange": { "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.", "$ref": "GoogleTypeInterval" }, "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" }, "pageToken": { "type": "string", "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." }, "filters": { "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\"", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1ComputeEnvironmentScoresRequestFilter" } } }, "id": "GoogleCloudApigeeV1ComputeEnvironmentScoresRequest" }, "GoogleCloudApigeeV1QueryTimeSeriesStatsRequest": { "id": "GoogleCloudApigeeV1QueryTimeSeriesStatsRequest", "type": "object", "properties": { "dimensions": { "items": { "type": "string" }, "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.", "type": "array" }, "timeRange": { "description": "Required. Time range for the stats.", "$ref": "GoogleTypeInterval" }, "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" }, "pageSize": { "format": "int32", "type": "integer", "description": "Page size represents the number of time series sequences, one per unique set of dimensions and their values." }, "metrics": { "items": { "$ref": "GoogleCloudApigeeV1MetricAggregation" }, "description": "Required. List of metrics and their aggregations.", "type": "array" }, "filter": { "type": "string", "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" }, "windowSize": { "enumDescriptions": [ "Unspecified window size. Default is 1 hour.", "1 Minute window", "1 Hour window", "1 Day window", "1 Month window" ], "type": "string", "description": "Time buckets to group the stats by.", "enum": [ "WINDOW_SIZE_UNSPECIFIED", "MINUTE", "HOUR", "DAY", "MONTH" ] }, "pageToken": { "type": "string", "description": "Page token stands for a specific collection of time series sequences." } }, "description": "QueryTimeSeriesStatsRequest represents a query that returns a collection of time series sequences grouped by their values." }, "GoogleCloudApigeeV1PodStatus": { "id": "GoogleCloudApigeeV1PodStatus", "type": "object", "properties": { "deploymentStatusTime": { "type": "string", "description": "Time the deployment status was reported in milliseconds since epoch.", "format": "int64" }, "deploymentTime": { "description": "Time the proxy was deployed in milliseconds since epoch.", "type": "string", "format": "int64" }, "statusCodeDetails": { "type": "string", "description": "Human-readable message associated with the status code." }, "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" }, "podStatusTime": { "type": "string", "description": "Time the pod status was reported in milliseconds since epoch.", "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" }, "statusCode": { "description": "Code associated with the deployment status.", "type": "string" }, "appVersion": { "type": "string", "description": "Version of the application running in the pod." } } }, "GoogleCloudApigeeV1EndpointChainingRule": { "id": "GoogleCloudApigeeV1EndpointChainingRule", "description": "EndpointChainingRule specifies the proxies contained in a particular deployment group, so that other deployment groups can find them in chaining calls.", "type": "object", "properties": { "proxyIds": { "description": "List of proxy ids which may be found in the given deployment group.", "type": "array", "items": { "type": "string" } }, "deploymentGroup": { "type": "string", "description": "The deployment group to target for cross-shard chaining calls to these proxies." } } }, "GoogleCloudApigeeV1ListRatePlansResponse": { "description": "Response for ListRatePlans.", "type": "object", "properties": { "ratePlans": { "type": "array", "description": "List of rate plans in an organization.", "items": { "$ref": "GoogleCloudApigeeV1RatePlan" } }, "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" } }, "id": "GoogleCloudApigeeV1ListRatePlansResponse" }, "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.", "type": "object", "properties": { "operationConfigs": { "description": "Required. List of operation configurations for either Apigee API proxies or other remote services that are associated with this API product.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1OperationConfig" } }, "operationConfigType": { "type": "string", "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." } }, "id": "GoogleCloudApigeeV1OperationGroup" }, "GoogleCloudApigeeV1SecurityProfile": { "description": "Represents a SecurityProfile resource.", "type": "object", "properties": { "name": { "description": "Immutable. Name of the security profile resource. Format: organizations/{org}/securityProfiles/{profile}", "type": "string" }, "revisionCreateTime": { "type": "string", "description": "Output only. The time when revision was created.", "readOnly": true, "format": "google-datetime" }, "scoringConfigs": { "items": { "$ref": "GoogleCloudApigeeV1SecurityProfileScoringConfig" }, "description": "List of profile scoring configs in this revision.", "type": "array" }, "maxScore": { "type": "integer", "description": "Output only. Maximum security score that can be generated by this profile.", "readOnly": true, "format": "int32" }, "profileConfig": { "description": "Required. Customized profile configuration that computes the security score.", "$ref": "GoogleCloudApigeeV1ProfileConfig" }, "displayName": { "type": "string", "description": "DEPRECATED: DO NOT USE Display name of the security profile.", "deprecated": true }, "environments": { "type": "array", "description": "List of environments attached to security profile.", "items": { "$ref": "GoogleCloudApigeeV1SecurityProfileEnvironment" } }, "minScore": { "description": "Output only. Minimum security score that can be generated by this profile.", "type": "integer", "readOnly": true, "format": "int32" }, "description": { "description": "Description of the security profile.", "type": "string" }, "revisionId": { "readOnly": true, "format": "int64", "type": "string", "description": "Output only. Revision ID of the security profile." }, "revisionUpdateTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. The time when revision was updated.", "type": "string" }, "revisionPublishTime": { "type": "string", "readOnly": true, "format": "google-datetime", "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.", "deprecated": true } }, "id": "GoogleCloudApigeeV1SecurityProfile" }, "GoogleCloudApigeeV1ListNatAddressesResponse": { "description": "Response for ListNatAddresses.", "type": "object", "properties": { "natAddresses": { "description": "List of NAT Addresses for the instance.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1NatAddress" } }, "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" } }, "id": "GoogleCloudApigeeV1ListNatAddressesResponse" }, "GoogleCloudApigeeV1ListSecurityProfilesV2Response": { "id": "GoogleCloudApigeeV1ListSecurityProfilesV2Response", "type": "object", "properties": { "securityProfilesV2": { "type": "array", "description": "List of security profiles in the organization.", "items": { "$ref": "GoogleCloudApigeeV1SecurityProfileV2" } }, "nextPageToken": { "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": "string" } }, "description": "Response for ListSecurityProfilesV2." }, "GoogleCloudApigeeV1DebugSession": { "id": "GoogleCloudApigeeV1DebugSession", "type": "object", "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" }, "count": { "format": "int32", "type": "integer", "description": "Optional. The number of request to be traced. Min = 1, Max = 15, Default = 10." }, "name": { "type": "string", "description": "A unique ID for this DebugSession." }, "validity": { "type": "integer", "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.", "format": "int32" }, "timeout": { "format": "int64", "type": "string", "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." }, "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." } } }, "GoogleCloudApigeeV1Property": { "description": "A single property entry in the Properties message.", "type": "object", "properties": { "name": { "description": "The property key", "type": "string" }, "value": { "description": "The property value", "type": "string" } }, "id": "GoogleCloudApigeeV1Property" }, "GoogleCloudApigeeV1SecurityProfileEnvironmentAssociation": { "type": "object", "properties": { "securityProfileRevisionId": { "description": "DEPRECATED: DO NOT USE Revision ID of the security profile.", "type": "string", "deprecated": true, "format": "int64" }, "attachTime": { "description": "Output only. The time when environment was attached to the security profile.", "type": "string", "readOnly": true, "format": "google-datetime" }, "name": { "description": "Immutable. Name of the environment that the profile is attached to.", "type": "string" } }, "description": "Represents a SecurityProfileEnvironmentAssociation resource.", "id": "GoogleCloudApigeeV1SecurityProfileEnvironmentAssociation" }, "GoogleCloudApigeeV1ProfileConfigThreat": { "description": "By default, following policies will be included: - XMLThreatProtection - JSONThreatProtection", "type": "object", "properties": {}, "id": "GoogleCloudApigeeV1ProfileConfigThreat" }, "GoogleCloudApigeeV1QueryTimeSeriesStatsResponseSequence": { "type": "object", "properties": { "dimensions": { "type": "object", "description": "Map of dimensions and their values that uniquely identifies a time series sequence.", "additionalProperties": { "type": "string" } }, "points": { "type": "array", "description": "List of points. First value of each inner list is a timestamp.", "items": { "type": "array", "items": { "type": "any" } } } }, "description": "A sequence of time series.", "id": "GoogleCloudApigeeV1QueryTimeSeriesStatsResponseSequence" }, "GoogleCloudApigeeV1ProfileConfigAbuse": { "id": "GoogleCloudApigeeV1ProfileConfigAbuse", "type": "object", "properties": {}, "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." }, "GoogleCloudApigeeV1RuntimeConfig": { "id": "GoogleCloudApigeeV1RuntimeConfig", "description": "Runtime configuration for the organization. Response for GetRuntimeConfig.", "type": "object", "properties": { "name": { "description": "Name of the resource in the following format: `organizations/{org}/runtimeConfig`.", "type": "string" }, "analyticsBucket": { "description": "Cloud Storage bucket used for uploading Analytics records.", "type": "string" }, "tenantProjectId": { "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.", "type": "string", "readOnly": true }, "traceBucket": { "description": "Cloud Storage bucket used for uploading Trace records.", "type": "string" } } }, "GoogleCloudApigeeV1QueryTabularStatsResponse": { "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", "properties": { "nextPageToken": { "type": "string", "description": "Next page token." }, "values": { "type": "array", "description": "Resultant rows from the executed query.", "items": { "type": "array", "items": { "type": "any" } } }, "columns": { "items": { "type": "string" }, "type": "array", "description": "Column names corresponding to the same order as the inner values in the stats field." } } }, "GoogleCloudApigeeV1GenerateDownloadUrlRequest": { "id": "GoogleCloudApigeeV1GenerateDownloadUrlRequest", "description": "Request for GenerateDownloadUrl method.", "type": "object", "properties": {} }, "GoogleCloudApigeeV1GetAsyncQueryResultUrlResponseURLInfo": { "type": "object", "properties": { "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": { "type": "string", "description": "The MD5 Hash of the JSON data" }, "sizeBytes": { "format": "int64", "type": "string", "description": "The size of the returned file in bytes" } }, "description": "A Signed URL and the relevant metadata associated with it.", "id": "GoogleCloudApigeeV1GetAsyncQueryResultUrlResponseURLInfo" }, "GoogleCloudApigeeV1ConfigVersion": { "description": "Version of the API proxy configuration schema. Currently, only 4.0 is supported.", "type": "object", "properties": { "majorVersion": { "type": "integer", "description": "Major version of the API proxy configuration schema.", "format": "int32" }, "minorVersion": { "description": "Minor version of the API proxy configuration schema.", "type": "integer", "format": "int32" } }, "id": "GoogleCloudApigeeV1ConfigVersion" }, "GoogleCloudApigeeV1LlmTokenQuota": { "type": "object", "properties": { "interval": { "type": "string", "description": "Required. Time interval over which the number of request messages is calculated." }, "limit": { "description": "Required. Upper limit of LLM tokens allowed for the time interval and time unit specified. Requests exceeding this limit will be rejected.", "type": "string" }, "timeUnit": { "description": "Optional. 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.", "type": "string" } }, "description": "LLM Token Quota contains the essential parameters needed that can be applied on the resources, methods, models, API source combination associated with this API product. While LLM Token Quota is optional, setting it prevents requests from exceeding the provisioned parameters.", "id": "GoogleCloudApigeeV1LlmTokenQuota" }, "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.", "type": "object", "properties": { "conditionConfig": { "description": "Required. A valid SecurityAction must contain at least one condition.", "$ref": "GoogleCloudApigeeV1SecurityActionConditionConfig" }, "flag": { "description": "Flag a request through if it matches this SecurityAction.", "$ref": "GoogleCloudApigeeV1SecurityActionFlag" }, "description": { "type": "string", "description": "Optional. An optional user provided description of the SecurityAction." }, "ttl": { "type": "string", "description": "Input only. The TTL for this SecurityAction.", "format": "google-duration" }, "allow": { "description": "Allow a request through if it matches this SecurityAction.", "$ref": "GoogleCloudApigeeV1SecurityActionAllow" }, "updateTime": { "description": "Output only. The update time for this SecurityAction. This reflects when this SecurityAction changed states.", "type": "string", "readOnly": true, "format": "google-datetime" }, "deny": { "description": "Deny a request through if it matches this SecurityAction.", "$ref": "GoogleCloudApigeeV1SecurityActionDeny" }, "expireTime": { "format": "google-datetime", "type": "string", "description": "The expiration for this SecurityAction." }, "createTime": { "type": "string", "description": "Output only. The create time for this SecurityAction.", "readOnly": true, "format": "google-datetime" }, "state": { "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." ], "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" }, "name": { "type": "string", "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}" }, "apiProxies": { "type": "array", "description": "Optional. If unset, this would apply to all proxies in the environment. If set, this action is enforced only if at least one proxy in the repeated list is deployed at the time of enforcement. If set, several restrictions are enforced on SecurityActions. There can be at most 100 enabled actions with proxies set in an env. Several other restrictions apply on conditions and are detailed later.", "items": { "type": "string" } } }, "id": "GoogleCloudApigeeV1SecurityAction" }, "GoogleCloudApigeeV1ConnectorsPlatformConfig": { "id": "GoogleCloudApigeeV1ConnectorsPlatformConfig", "description": "Configuration for the Connectors Platform add-on.", "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Flag that specifies whether the Connectors Platform add-on is enabled." }, "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" } } }, "GoogleCloudApigeeV1SetAddonsRequest": { "id": "GoogleCloudApigeeV1SetAddonsRequest", "description": "Request for SetAddons.", "type": "object", "properties": { "addonsConfig": { "description": "Required. Add-on configurations.", "$ref": "GoogleCloudApigeeV1AddonsConfig" } } }, "GoogleCloudApigeeV1ApiProductRef": { "id": "GoogleCloudApigeeV1ApiProductRef", "type": "object", "properties": { "apiproduct": { "description": "Name of the API product.", "type": "string" }, "status": { "description": "Status of the API product. Valid values are `approved` or `revoked`.", "type": "string" } } }, "GoogleCloudApigeeV1ListDnsZonesResponse": { "type": "object", "properties": { "nextPageToken": { "description": "Page token that you can include in an `ListDnsZones` request to retrieve the next page. If omitted, no subsequent pages exist.", "type": "string" }, "dnsZones": { "items": { "$ref": "GoogleCloudApigeeV1DnsZone" }, "description": "DNS zones in a given organization.", "type": "array" } }, "description": "Response for list DNS zones.", "id": "GoogleCloudApigeeV1ListDnsZonesResponse" }, "GoogleCloudApigeeV1ApiProduct": { "id": "GoogleCloudApigeeV1ApiProduct", "type": "object", "properties": { "attributes": { "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.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1Attribute" } }, "llmOperationGroup": { "description": "Optional. Configuration used to group Apigee proxies with resources, method types, LLM model 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, specific LLM model 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 llm operation group; otherwise the call will fail.", "$ref": "GoogleCloudApigeeV1LlmOperationGroup" }, "environments": { "type": "array", "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`.", "items": { "type": "string" } }, "grpcOperationGroup": { "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.", "$ref": "GoogleCloudApigeeV1GrpcOperationGroup" }, "quotaTimeUnit": { "description": "Time unit defined for the `quotaInterval`. Valid values include `minute`, `hour`, `day`, or `month`.", "type": "string" }, "approvalType": { "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.", "type": "string" }, "graphqlOperationGroup": { "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.", "$ref": "GoogleCloudApigeeV1GraphQLOperationGroup" }, "lastModifiedAt": { "type": "string", "description": "Response only. Modified time of this environment as milliseconds since epoch.", "format": "int64" }, "space": { "type": "string", "description": "Optional. The resource ID of the parent Space. If not set, the parent resource will be the Organization. To learn how Spaces can be used to manage resources, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview)." }, "scopes": { "items": { "type": "string" }, "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.", "type": "array" }, "apiResources": { "type": "array", "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.", "items": { "type": "string" } }, "quota": { "type": "string", "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." }, "llmQuotaInterval": { "type": "string", "description": "Optional. Time interval over which the number of tokens from LLM responses is calculated." }, "quotaInterval": { "type": "string", "description": "Time interval over which the number of request messages is calculated." }, "description": { "type": "string", "description": "Description of the API product. Include key information about the API product that is not captured by other fields." }, "llmQuota": { "description": "Optional. Number of LLM tokens permitted per app by this API product for the specified `llm_quota_interval` and `llm_quota_time_unit`. For example, an `llm_quota` of 50,000, for an `llm_quota_interval` of 12 and an `llm_quota_time_unit` of hours means 50,000 llm tokens are allowed to be used every 12 hours.", "type": "string" }, "proxies": { "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.", "type": "array", "items": { "type": "string" } }, "operationGroup": { "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.", "$ref": "GoogleCloudApigeeV1OperationGroup" }, "displayName": { "type": "string", "description": "Name displayed in the UI or developer portal to developers registering for API access." }, "name": { "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.", "type": "string" }, "llmQuotaTimeUnit": { "description": "Optional. Time unit defined for the `llm_quota_interval`. Valid values include `minute`, `hour`, `day`, or `month`.", "type": "string" }, "createdAt": { "description": "Response only. Creation time of this environment as milliseconds since epoch.", "type": "string", "format": "int64" }, "quotaCounterScope": { "type": "string", "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.", "enum": [ "QUOTA_COUNTER_SCOPE_UNSPECIFIED", "PROXY", "OPERATION", "PRODUCT" ], "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.", "When quota is not explicitly defined for each operation(REST/GraphQL), the limits set at product level will be used as a global counter for quota evaluation by all the operations." ] } } }, "GoogleCloudApigeeV1CustomReport": { "type": "object", "properties": { "dimensions": { "items": { "type": "string" }, "type": "array", "description": "This contains the list of dimensions for the report" }, "lastViewedAt": { "readOnly": true, "format": "int64", "description": "Output only. Last viewed time of this entity as milliseconds since epoch", "type": "string" }, "filter": { "description": "This field contains the filter expression", "type": "string" }, "chartType": { "type": "string", "description": "This field contains the chart type for the report" }, "displayName": { "type": "string", "description": "This is the display name for the report" }, "name": { "type": "string", "description": "Required. Unique identifier for the report T his is a legacy field used to encode custom report unique id" }, "tags": { "items": { "type": "string" }, "type": "array", "description": "Legacy field: not used. This field contains a list of tags associated with custom report" }, "environment": { "readOnly": true, "type": "string", "description": "Output only. Environment name" }, "createdAt": { "description": "Output only. Unix time when the app was created json key: createdAt", "type": "string", "readOnly": true, "format": "int64" }, "sortByCols": { "items": { "type": "string" }, "type": "array", "description": "Legacy field: not used much. Contains the list of sort by columns" }, "sortOrder": { "type": "string", "description": "Legacy field: not used much. Contains the sort order for the sort columns" }, "toTime": { "description": "Legacy field: not used. Contains the end time for the report", "type": "string" }, "organization": { "type": "string", "description": "Output only. Organization name", "readOnly": true }, "metrics": { "items": { "$ref": "GoogleCloudApigeeV1CustomReportMetric" }, "description": "Required. This contains the list of metrics", "type": "array" }, "limit": { "type": "string", "description": "Legacy field: not used This field contains the limit for the result retrieved" }, "lastModifiedAt": { "type": "string", "description": "Output only. Modified time of this entity as milliseconds since epoch. json key: lastModifiedAt", "readOnly": true, "format": "int64" }, "topk": { "description": "Legacy field: not used. This field contains the top k parameter value for restricting the result", "type": "string" }, "timeUnit": { "description": "This field contains the time unit of aggregation for the report", "type": "string" }, "fromTime": { "type": "string", "description": "Legacy field: not used. Contains the from time for the report" }, "properties": { "type": "array", "description": "This field contains report properties such as ui metadata etc.", "items": { "$ref": "GoogleCloudApigeeV1ReportProperty" } }, "offset": { "description": "Legacy field: not used. This field contains the offset for the data", "type": "string" }, "comments": { "description": "Legacy field: not used. This field contains a list of comments associated with custom report", "type": "array", "items": { "type": "string" } } }, "id": "GoogleCloudApigeeV1CustomReport" }, "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsResponse": { "id": "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsResponse", "type": "object", "properties": { "nextPageToken": { "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.", "type": "string" }, "assessmentTime": { "format": "google-datetime", "type": "string", "description": "The time of the assessment api call." }, "securityAssessmentResults": { "description": "Default sort order is by resource name in alphabetic order.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1SecurityAssessmentResult" } } }, "description": "Response for BatchComputeSecurityAssessmentResults." }, "GoogleCloudApigeeV1SecurityProfileV2": { "id": "GoogleCloudApigeeV1SecurityProfileV2", "type": "object", "properties": { "profileAssessmentConfigs": { "description": "Required. The configuration for each assessment in this profile. Key is the name/id of the assessment.", "additionalProperties": { "$ref": "GoogleCloudApigeeV1SecurityProfileV2ProfileAssessmentConfig" }, "type": "object" }, "name": { "type": "string", "description": "Identifier. Name of the security profile v2 resource. Format: organizations/{org}/securityProfilesV2/{profile}" }, "updateTime": { "description": "Output only. The time of the security profile update.", "type": "string", "readOnly": true, "format": "google-datetime" }, "googleDefined": { "readOnly": true, "description": "Output only. Whether the security profile is google defined.", "type": "boolean" }, "riskAssessmentType": { "enumDescriptions": [ "Risk assessment type is not specified.", "Risk assessment type is Apigee.", "Risk assessment type is API Hub." ], "type": "string", "description": "Optional. The risk assessment type of the security profile. Defaults to ADVANCED_API_SECURITY.", "enum": [ "RISK_ASSESSMENT_TYPE_UNSPECIFIED", "APIGEE", "API_HUB" ] }, "description": { "description": "Optional. The description of the security profile.", "type": "string" }, "createTime": { "type": "string", "description": "Output only. The time of the security profile creation.", "readOnly": true, "format": "google-datetime" } }, "description": "Security profile for risk assessment version 2." }, "GoogleCloudApigeeV1SecurityReport": { "id": "GoogleCloudApigeeV1SecurityReport", "type": "object", "properties": { "created": { "type": "string", "description": "Creation time of the query." }, "error": { "description": "Error is set when query fails.", "type": "string" }, "result": { "description": "Result is available only after the query is completed.", "$ref": "GoogleCloudApigeeV1SecurityReportResultMetadata" }, "queryParams": { "description": "Contains information like metrics, dimenstions etc of the Security Report.", "$ref": "GoogleCloudApigeeV1SecurityReportMetadata" }, "self": { "type": "string", "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`" }, "executionTime": { "type": "string", "description": "ExecutionTime is available only after the query is completed." }, "resultFileSize": { "description": "ResultFileSize is available only after the query is completed.", "type": "string" }, "state": { "type": "string", "description": "Query state could be \"enqueued\", \"running\", \"completed\", \"expired\" and \"failed\"." }, "updated": { "type": "string", "description": "Output only. Last updated timestamp for the query.", "readOnly": true }, "displayName": { "description": "Display Name specified by the user.", "type": "string" }, "resultRows": { "format": "int64", "type": "string", "description": "ResultRows is available only after the query is completed." }, "envgroupHostname": { "description": "Hostname is available only when query is executed at host level.", "type": "string" }, "reportDefinitionId": { "description": "Report Definition ID.", "type": "string" } }, "description": "SecurityReport saves all the information about the created security report." }, "GoogleCloudApigeeV1IngressConfig": { "id": "GoogleCloudApigeeV1IngressConfig", "type": "object", "properties": { "environmentGroups": { "items": { "$ref": "GoogleCloudApigeeV1EnvironmentGroupConfig" }, "description": "List of environment groups in the organization.", "type": "array" }, "uid": { "type": "string", "description": "A unique id for the ingress config that will only change if the organization is deleted and recreated." }, "name": { "description": "Name of the resource in the following format: `organizations/{org}/deployedIngressConfig`.", "type": "string" }, "revisionCreateTime": { "description": "Time at which the IngressConfig revision was created.", "type": "string", "format": "google-datetime" }, "revisionId": { "format": "int64", "description": "Revision id that defines the ordering on IngressConfig resources. The higher the revision, the more recently the configuration was deployed.", "type": "string" } } }, "GoogleCloudApigeeV1GenerateUploadUrlRequest": { "id": "GoogleCloudApigeeV1GenerateUploadUrlRequest", "description": "Request for GenerateUploadUrl method.", "type": "object", "properties": {} }, "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestApiHubApiArray": { "id": "GoogleCloudApigeeV1BatchComputeSecurityAssessmentResultsRequestApiHubApiArray", "description": "Message for the array of API Hub APIs.", "type": "object", "properties": { "apis": { "type": "array", "description": "Required. The array of API Hub API IDs. Format: `projects/{project}/locations/{location}/apis/{api}`", "items": { "type": "string" } } } }, "GoogleCloudApigeeV1GetSyncAuthorizationRequest": { "description": "Request for GetSyncAuthorization.", "type": "object", "properties": {}, "id": "GoogleCloudApigeeV1GetSyncAuthorizationRequest" }, "GoogleCloudApigeeV1ReportInstanceStatusRequest": { "description": "Request for ReportInstanceStatus.", "type": "object", "properties": { "resources": { "items": { "$ref": "GoogleCloudApigeeV1ResourceStatus" }, "description": "Status for config resources", "type": "array" }, "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." }, "reportTime": { "format": "google-datetime", "type": "string", "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." } }, "id": "GoogleCloudApigeeV1ReportInstanceStatusRequest" }, "GoogleCloudApigeeV1AppGroupAppKey": { "type": "object", "properties": { "issuedAt": { "readOnly": true, "format": "int64", "type": "string", "description": "Output only. Time the AppGroup app was created in milliseconds since epoch." }, "apiProducts": { "type": "array", "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.", "readOnly": true, "items": { "$ref": "GoogleCloudApigeeV1APIProductAssociation" } }, "attributes": { "description": "List of attributes associated with the credential.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1Attribute" } }, "expiresAt": { "type": "string", "description": "Output only. Time the AppGroup app expires in milliseconds since epoch.", "readOnly": true, "format": "int64" }, "consumerSecret": { "description": "Secret key.", "type": "string" }, "consumerKey": { "type": "string", "description": "Immutable. Consumer key." }, "status": { "description": "Status of the credential. Valid values include `approved` or `revoked`.", "type": "string" }, "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" }, "scopes": { "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.", "type": "array", "items": { "type": "string" } } }, "description": "AppGroupAppKey contains all the information associated with the credentials.", "id": "GoogleCloudApigeeV1AppGroupAppKey" }, "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.", "type": "object", "properties": { "violations": { "description": "Describes all precondition violations.", "type": "array", "items": { "$ref": "GoogleRpcPreconditionFailureViolation" } } }, "id": "GoogleRpcPreconditionFailure" }, "GoogleCloudApigeeV1ApiSecurityConfig": { "id": "GoogleCloudApigeeV1ApiSecurityConfig", "description": "Configurations of the API Security add-on.", "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Flag that specifies whether the API security add-on is enabled." }, "expiresAt": { "type": "string", "description": "Output only. Time at which the API Security add-on expires in milliseconds since epoch. If unspecified, the add-on will never expire.", "readOnly": true, "format": "int64" } } }, "GoogleCloudApigeeV1ListApiProductsResponse": { "type": "object", "properties": { "apiProduct": { "description": "Lists all API product names defined for an organization.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1ApiProduct" } } }, "id": "GoogleCloudApigeeV1ListApiProductsResponse" }, "GoogleCloudApigeeV1Alias": { "description": "Reference to a certificate or key/certificate pair.", "type": "object", "properties": { "alias": { "description": "Resource ID for this alias. Values must match the regular expression `[^/]{1,255}`.", "type": "string" }, "certsInfo": { "description": "Chain of certificates under this alias.", "$ref": "GoogleCloudApigeeV1Certificate" }, "type": { "description": "Type of alias.", "enum": [ "ALIAS_TYPE_UNSPECIFIED", "CERT", "KEY_CERT" ], "type": "string", "enumDescriptions": [ "Alias type is not specified.", "Certificate.", "Key/certificate pair." ] } }, "id": "GoogleCloudApigeeV1Alias" }, "GoogleCloudApigeeV1ComputeEnvironmentScoresRequestFilter": { "id": "GoogleCloudApigeeV1ComputeEnvironmentScoresRequestFilter", "type": "object", "properties": { "scorePath": { "description": "Optional. Return scores for this component. Example: \"/org@myorg/envgroup@myenvgroup/env@myenv/proxies/proxy@myproxy/source\"", "type": "string" } }, "description": "Filter scores by component path. Used custom filter instead of AIP-160 as the use cases are highly constrained and predictable." }, "GoogleCloudApigeeV1SecurityFeedback": { "id": "GoogleCloudApigeeV1SecurityFeedback", "description": "Represents a feedback report from an Advanced API Security customer.", "type": "object", "properties": { "feedbackType": { "enumDescriptions": [ "Unspecified feedback type.", "Feedback identifying attributes to be excluded from detections." ], "type": "string", "description": "Required. The type of feedback being submitted.", "enum": [ "FEEDBACK_TYPE_UNSPECIFIED", "EXCLUDED_DETECTION" ] }, "feedbackContexts": { "description": "Required. One or more attribute/value pairs for constraining the feedback.", "type": "array", "items": { "$ref": "GoogleCloudApigeeV1SecurityFeedbackFeedbackContext" } }, "createTime": { "readOnly": true, "format": "google-datetime", "type": "string", "description": "Output only. The time when this specific feedback id was created." }, "displayName": { "type": "string", "description": "Optional. The display name of the feedback." }, "name": { "readOnly": true, "description": "Output only. Identifier. The feedback name is intended to be a system-generated uuid.", "type": "string" }, "updateTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. The time when this specific feedback id was updated.", "type": "string" }, "reason": { "enumDescriptions": [ "Unspecified reason.", "The feedback is created for an internal system.", "The feedback is created for a non-risk client.", "The feedback is created for to label NAT.", "The feedback is created for a penetration test.", "The feedback is created for other reasons." ], "description": "Optional. The reason for the feedback.", "enum": [ "REASON_UNSPECIFIED", "INTERNAL_SYSTEM", "NON_RISK_CLIENT", "NAT", "PENETRATION_TEST", "OTHER" ], "type": "string" }, "comment": { "description": "Optional. Optional text the user can provide for additional, unstructured context.", "type": "string" } } }, "GoogleCloudApigeeV1AsyncQueryResultView": { "id": "GoogleCloudApigeeV1AsyncQueryResultView", "type": "object", "properties": { "code": { "format": "int32", "type": "integer", "description": "Error code when there is a failure." }, "metadata": { "description": "Metadata contains information like metrics, dimenstions etc of the AsyncQuery.", "$ref": "GoogleCloudApigeeV1QueryMetadata" }, "error": { "type": "string", "description": "Error message when there is a failure." }, "rows": { "items": { "type": "any" }, "description": "Rows of query result. Each row is a JSON object. Example: {sum(message_count): 1, developer_app: \"(not set)\",…}", "type": "array" }, "state": { "type": "string", "description": "State of retrieving ResultView." } } }, "GoogleCloudApigeeV1Operation": { "id": "GoogleCloudApigeeV1Operation", "description": "Represents the pairing of REST resource path and the actions (verbs) allowed on the resource path.", "type": "object", "properties": { "resource": { "type": "string", "description": "Required. REST resource path associated with the API proxy or remote service." }, "methods": { "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", "items": { "type": "string" } } } }, "GoogleCloudApigeeV1ScoreComponentRecommendation": { "description": "Recommendation based on security concerns and score.", "type": "object", "properties": { "description": { "type": "string", "description": "Description of the recommendation." }, "impact": { "format": "int32", "description": "Potential impact of this recommendation on the overall score. This denotes how important this recommendation is to improve the score.", "type": "integer" }, "title": { "description": "Title represents recommendation title.", "type": "string" }, "actions": { "type": "array", "description": "Actions for the recommendation to improve the security score.", "items": { "$ref": "GoogleCloudApigeeV1ScoreComponentRecommendationAction" } } }, "id": "GoogleCloudApigeeV1ScoreComponentRecommendation" } }, "batchPath": "batch", "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.", "servicePath": "", "documentationLink": "https://cloud.google.com/apigee-api-management/", "version": "v1", "mtlsRootUrl": "https://apigee.mtls.googleapis.com/", "id": "apigee:v1", "kind": "discovery#restDescription", "fullyEncodeReservedExpansion": true, "rootUrl": "https://apigee.googleapis.com/", "protocol": "rest", "ownerName": "Google", "discoveryVersion": "v1", "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." } } } }, "version_module": true }