Google Cloud Api Gateway V1 Client - Class ApiConfig (1.2.2)

Version 1.2.2

• 2.0.2 (latest)
• 2.0.1
• 1.3.5
• 1.2.2
• 1.1.1
• 1.0.5

Reference documentation and code samples for the Google Cloud Api Gateway V1 Client class ApiConfig.

An API Configuration is a combination of settings for both the Managed Service and Gateways serving this API Config.

Generated from protobuf message google.cloud.apigateway.v1.ApiConfig

Namespace

Google \ Cloud \ ApiGateway \ V1

Methods

__construct

Constructor.

Parameters
Name	Description
data	array Optional. Data for populating the Message object.
↳ name	string Output only. Resource name of the API Config. Format: projects/{project}/locations/global/apis/{api}/configs/{api_config}
↳ create_time	Google\Protobuf\Timestamp Output only. Created time.
↳ update_time	Google\Protobuf\Timestamp Output only. Updated time.
↳ labels	array|Google\Protobuf\Internal\MapField 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
↳ display_name	string Optional. Display name.
↳ gateway_service_account	string 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 ({ACCOUNT_ID}@{PROJECT}.iam.gserviceaccount.com) or its full resource name (projects/{PROJECT}/accounts/{UNIQUE_ID}). This is most often used when the service is a GCP resource such as a Cloud Run Service or an IAP-secured service.
↳ service_config_id	string Output only. The ID of the associated Service Config ( https://cloud.google.com/service-infrastructure/docs/glossary#config).
↳ state	int Output only. State of the API Config.
↳ openapi_documents	array<Google\Cloud\ApiGateway\V1\ApiConfig\OpenApiDocument> Optional. OpenAPI specification documents. If specified, grpc_services and managed_service_configs must not be included.
↳ grpc_services	array<Google\Cloud\ApiGateway\V1\ApiConfig\GrpcServiceDefinition> Optional. gRPC service definition files. If specified, openapi_documents must not be included.
↳ managed_service_configs	array<Google\Cloud\ApiGateway\V1\ApiConfig\File> 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.

getName

Output only. Resource name of the API Config.

Format: projects/{project}/locations/global/apis/{api}/configs/{api_config}

Returns
Type	Description
string

setName

Output only. Resource name of the API Config.

Format: projects/{project}/locations/global/apis/{api}/configs/{api_config}

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getCreateTime

Output only. Created time.

Returns
Type	Description
Google\Protobuf\Timestamp|null

hasCreateTime

clearCreateTime

setCreateTime

Output only. Created time.

Parameter
Name	Description
var	Google\Protobuf\Timestamp

Returns
Type	Description
$this

getUpdateTime

Output only. Updated time.

Returns
Type	Description
Google\Protobuf\Timestamp|null

hasUpdateTime

clearUpdateTime

setUpdateTime

Output only. Updated time.

Parameter
Name	Description
var	Google\Protobuf\Timestamp

Returns
Type	Description
$this

getLabels

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

Returns
Type	Description
Google\Protobuf\Internal\MapField

setLabels

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

Parameter
Name	Description
var	array|Google\Protobuf\Internal\MapField

Returns
Type	Description
$this

getDisplayName

Optional. Display name.

Returns
Type	Description
string

setDisplayName

Optional. Display name.

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getGatewayServiceAccount

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 ({ACCOUNT_ID}@{PROJECT}.iam.gserviceaccount.com) or its full resource name (projects/{PROJECT}/accounts/{UNIQUE_ID}). This is most often used when the service is a GCP resource such as a Cloud Run Service or an IAP-secured service.

Returns
Type	Description
string

setGatewayServiceAccount

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 ({ACCOUNT_ID}@{PROJECT}.iam.gserviceaccount.com) or its full resource name (projects/{PROJECT}/accounts/{UNIQUE_ID}). This is most often used when the service is a GCP resource such as a Cloud Run Service or an IAP-secured service.

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getServiceConfigId

Output only. The ID of the associated Service Config ( https://cloud.google.com/service-infrastructure/docs/glossary#config).

Returns
Type	Description
string

setServiceConfigId

Output only. The ID of the associated Service Config ( https://cloud.google.com/service-infrastructure/docs/glossary#config).

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getState

Output only. State of the API Config.

Returns
Type	Description
int

setState

Output only. State of the API Config.

Parameter
Name	Description
var	int

Returns
Type	Description
$this

getOpenapiDocuments

Optional. OpenAPI specification documents. If specified, grpc_services and managed_service_configs must not be included.

Returns
Type	Description
Google\Protobuf\Internal\RepeatedField

setOpenapiDocuments

Optional. OpenAPI specification documents. If specified, grpc_services and managed_service_configs must not be included.

Parameter
Name	Description
var	array<Google\Cloud\ApiGateway\V1\ApiConfig\OpenApiDocument>

Returns
Type	Description
$this

getGrpcServices

Optional. gRPC service definition files. If specified, openapi_documents must not be included.

Returns
Type	Description
Google\Protobuf\Internal\RepeatedField

setGrpcServices

Optional. gRPC service definition files. If specified, openapi_documents must not be included.

Parameter
Name	Description
var	array<Google\Cloud\ApiGateway\V1\ApiConfig\GrpcServiceDefinition>

Returns
Type	Description
$this

getManagedServiceConfigs

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.

Returns
Type	Description
Google\Protobuf\Internal\RepeatedField

setManagedServiceConfigs

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.

Parameter
Name	Description
var	array<Google\Cloud\ApiGateway\V1\ApiConfig\File>

Returns
Type	Description
$this