- Resource: ApiConfig
- GatewayConfig
- BackendConfig
- State
- OpenApiDocument
- File
- GrpcServiceDefinition
- Methods
Resource: ApiConfig
An API Configuration is a combination of settings for both the Managed Service and Gateways serving this API Config.
JSON representation | |
---|---|
{ "name": string, "createTime": string, "updateTime": string, "labels": { string: string, ... }, "displayName": string, "gatewayConfig": { object ( |
Fields | |
---|---|
name |
Output only. Resource name of the API Config. Format: projects/{project}/locations/global/apis/{api}/configs/{apiConfig} |
createTime |
Output only. Created time. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
updateTime |
Output only. Updated time. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
labels |
Optional. Resource labels to represent user-provided metadata. Refer to cloud documentation on labels for more details. https://cloud.google.com/compute/docs/labeling-resources An object containing a list of |
displayName |
Optional. Display name. |
gatewayConfig |
Immutable. Gateway specific configuration. |
gatewayServiceAccount |
Immutable. The Google Cloud IAM Service Account that Gateways serving this config should use to authenticate to other services. This may either be the Service Account's email ( |
serviceConfigId |
Output only. The ID of the associated Service Config ( https://cloud.google.com/service-infrastructure/docs/glossary#config). |
state |
Output only. State of the API Config. |
openapiDocuments[] |
Optional. OpenAPI specification documents. If specified, grpcServices and managedServiceConfigs must not be included. |
grpcServices[] |
Optional. gRPC service definition files. If specified, openapiDocuments must not be included. |
managedServiceConfigs[] |
Optional. Service Configuration files. At least one must be included when using gRPC service definitions. See https://cloud.google.com/endpoints/docs/grpc/grpc-service-config#service_configuration_overview for the expected file contents. If multiple files are specified, the files are merged with the following rules: * All singular scalar fields are merged using "last one wins" semantics in the order of the files uploaded. * Repeated fields are concatenated. * Singular embedded messages are merged using these rules for nested fields. |
GatewayConfig
Configuration settings for Gateways.
JSON representation | |
---|---|
{
"backendConfig": {
object ( |
Fields | |
---|---|
backendConfig |
Required. Backend settings that are applied to all backends of the Gateway. |
BackendConfig
Configuration for all backends.
JSON representation | |
---|---|
{ "googleServiceAccount": string } |
Fields | |
---|---|
googleServiceAccount |
Google Cloud IAM service account used to sign OIDC tokens for backends that have authentication configured (https://cloud.google.com/service-infrastructure/docs/service-management/reference/rest/v1/services.configs#backend). This may either be the Service Account's email (i.e. "{ACCOUNT_ID}@{PROJECT}.iam.gserviceaccount.com") or its full resource name (i.e. "projects/{PROJECT}/accounts/{UNIQUE_ID}"). This is most often used when the backend is a GCP resource such as a Cloud Run Service or an IAP-secured service. Note that this token is always sent as an authorization header bearer token. The audience of the OIDC token is configured in the associated Service Config in the BackendRule option (https://github.com/googleapis/googleapis/blob/master/google/api/backend.proto#L125). |
State
All the possible API Config states.
Enums | |
---|---|
STATE_UNSPECIFIED |
API Config does not have a state yet. |
CREATING |
API Config is being created and deployed to the API Controller. |
ACTIVE |
API Config is ready for use by Gateways. |
FAILED |
API Config creation failed. |
DELETING |
API Config is being deleted. |
UPDATING |
API Config is being updated. |
ACTIVATING |
API Config settings are being activated in downstream systems. API Configs in this state cannot be used by Gateways. |
OpenApiDocument
An OpenAPI Specification Document describing an API.
JSON representation | |
---|---|
{
"document": {
object ( |
Fields | |
---|---|
document |
The OpenAPI Specification document file. |
File
A lightweight description of a file.
JSON representation | |
---|---|
{ "path": string, "contents": string } |
Fields | |
---|---|
path |
The file path (full or relative path). This is typically the path of the file when it is uploaded. |
contents |
The bytes that constitute the file. A base64-encoded string. |
GrpcServiceDefinition
A gRPC service definition.
JSON representation | |
---|---|
{ "fileDescriptorSet": { object ( |
Fields | |
---|---|
fileDescriptorSet |
Input only. File descriptor set, generated by protoc. To generate, use protoc with imports and source info included. For an example test.proto file, the following command would put the value in a new file named out.pb. $ protoc --include_imports --include_source_info test.proto -o out.pb |
source[] |
Optional. Uncompiled proto files associated with the descriptor set, used for display purposes (server-side compilation is not supported). These should match the inputs to 'protoc' command used to generate fileDescriptorSet. |
Methods |
|
---|---|
|
Creates a new ApiConfig in a given project and location. |
|
Deletes a single ApiConfig. |
|
Gets details of a single ApiConfig. |
|
Gets the access control policy for a resource. |
|
Lists ApiConfigs in a given project and location. |
|
Updates the parameters of a single ApiConfig. |
|
Sets the access control policy on the specified resource. |
|
Returns permissions that a caller has on the specified resource. |