The API Gateway Service is the interface for managing API Gateways.
Equality
Instances of this class created via copy-construction or copy-assignment always compare equal. Instances created with equal std::shared_ptr<*Connection>
objects compare equal. Objects that compare equal share the same underlying resources.
Performance
Creating a new instance of this class is a relatively expensive operation, new objects establish new connections to the service. In contrast, copy-construction, move-construction, and the corresponding assignment operations are relatively efficient as the copies share all underlying resources.
Thread Safety
Concurrent access to different instances of this class, even if they compare equal, is guaranteed to work. Two or more threads operating on the same instance of this class is not guaranteed to work. Since copy-construction and move-construction is a relatively efficient operation, consider using such a copy when using this class from multiple threads.
Constructors
ApiGatewayServiceClient(ApiGatewayServiceClient const &)
Copy and move support
Parameter | |
---|---|
Name | Description |
|
ApiGatewayServiceClient const &
|
ApiGatewayServiceClient(ApiGatewayServiceClient &&)
Copy and move support
Parameter | |
---|---|
Name | Description |
|
ApiGatewayServiceClient &&
|
ApiGatewayServiceClient(std::shared_ptr< ApiGatewayServiceConnection >, Options)
Parameters | |
---|---|
Name | Description |
connection |
std::shared_ptr< ApiGatewayServiceConnection >
|
opts |
Options
|
Operators
operator=(ApiGatewayServiceClient const &)
Copy and move support
Parameter | |
---|---|
Name | Description |
|
ApiGatewayServiceClient const &
|
Returns | |
---|---|
Type | Description |
ApiGatewayServiceClient & |
operator=(ApiGatewayServiceClient &&)
Copy and move support
Parameter | |
---|---|
Name | Description |
|
ApiGatewayServiceClient &&
|
Returns | |
---|---|
Type | Description |
ApiGatewayServiceClient & |
Functions
ListGateways(std::string const &, Options)
Lists Gateways in a given project and location.
Parameters | |
---|---|
Name | Description |
parent |
std::string const &
Required. Parent resource of the Gateway, of the form: |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::cloud::apigateway::v1::Gateway > | a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
ListGateways(google::cloud::apigateway::v1::ListGatewaysRequest, Options)
Lists Gateways in a given project and location.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::apigateway::v1::ListGatewaysRequest
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::cloud::apigateway::v1::Gateway > | a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
GetGateway(std::string const &, Options)
Gets details of a single Gateway.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. Resource name of the form: |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::apigateway::v1::Gateway > | the result of the RPC. The response message type (google.cloud.apigateway.v1.Gateway) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
GetGateway(google::cloud::apigateway::v1::GetGatewayRequest const &, Options)
Gets details of a single Gateway.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::apigateway::v1::GetGatewayRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::apigateway::v1::Gateway > | the result of the RPC. The response message type (google.cloud.apigateway.v1.Gateway) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
CreateGateway(std::string const &, google::cloud::apigateway::v1::Gateway const &, std::string const &, Options)
Creates a new Gateway in a given project and location.
Parameters | |
---|---|
Name | Description |
parent |
std::string const &
Required. Parent resource of the Gateway, of the form: |
gateway |
google::cloud::apigateway::v1::Gateway const &
Required. Gateway resource. |
gateway_id |
std::string const &
Required. Identifier to assign to the Gateway. Must be unique within scope of the parent resource. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::apigateway::v1::Gateway > > | A |
CreateGateway(google::cloud::apigateway::v1::CreateGatewayRequest const &, Options)
Creates a new Gateway in a given project and location.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::apigateway::v1::CreateGatewayRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::apigateway::v1::Gateway > > | A |
UpdateGateway(google::cloud::apigateway::v1::Gateway const &, google::protobuf::FieldMask const &, Options)
Updates the parameters of a single Gateway.
Parameters | |
---|---|
Name | Description |
gateway |
google::cloud::apigateway::v1::Gateway const &
Required. Gateway resource. |
update_mask |
google::protobuf::FieldMask const &
Field mask is used to specify the fields to be overwritten in the Gateway resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::apigateway::v1::Gateway > > | A |
UpdateGateway(google::cloud::apigateway::v1::UpdateGatewayRequest const &, Options)
Updates the parameters of a single Gateway.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::apigateway::v1::UpdateGatewayRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::apigateway::v1::Gateway > > | A |
DeleteGateway(std::string const &, Options)
Deletes a single Gateway.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. Resource name of the form: |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::apigateway::v1::OperationMetadata > > | A |
DeleteGateway(google::cloud::apigateway::v1::DeleteGatewayRequest const &, Options)
Deletes a single Gateway.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::apigateway::v1::DeleteGatewayRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::apigateway::v1::OperationMetadata > > | A |
ListApis(std::string const &, Options)
Lists Apis in a given project and location.
Parameters | |
---|---|
Name | Description |
parent |
std::string const &
Required. Parent resource of the API, of the form: |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::cloud::apigateway::v1::Api > | a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
ListApis(google::cloud::apigateway::v1::ListApisRequest, Options)
Lists Apis in a given project and location.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::apigateway::v1::ListApisRequest
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::cloud::apigateway::v1::Api > | a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
GetApi(std::string const &, Options)
Gets details of a single Api.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. Resource name of the form: |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::apigateway::v1::Api > | the result of the RPC. The response message type (google.cloud.apigateway.v1.Api) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
GetApi(google::cloud::apigateway::v1::GetApiRequest const &, Options)
Gets details of a single Api.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::apigateway::v1::GetApiRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::apigateway::v1::Api > | the result of the RPC. The response message type (google.cloud.apigateway.v1.Api) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
CreateApi(std::string const &, google::cloud::apigateway::v1::Api const &, std::string const &, Options)
Creates a new Api in a given project and location.
Parameters | |
---|---|
Name | Description |
parent |
std::string const &
Required. Parent resource of the API, of the form: |
api |
google::cloud::apigateway::v1::Api const &
Required. API resource. |
api_id |
std::string const &
Required. Identifier to assign to the API. Must be unique within scope of the parent resource. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::apigateway::v1::Api > > | A |
CreateApi(google::cloud::apigateway::v1::CreateApiRequest const &, Options)
Creates a new Api in a given project and location.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::apigateway::v1::CreateApiRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::apigateway::v1::Api > > | A |
UpdateApi(google::cloud::apigateway::v1::Api const &, google::protobuf::FieldMask const &, Options)
Updates the parameters of a single Api.
Parameters | |
---|---|
Name | Description |
api |
google::cloud::apigateway::v1::Api const &
Required. API resource. |
update_mask |
google::protobuf::FieldMask const &
Field mask is used to specify the fields to be overwritten in the Api resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::apigateway::v1::Api > > | A |
UpdateApi(google::cloud::apigateway::v1::UpdateApiRequest const &, Options)
Updates the parameters of a single Api.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::apigateway::v1::UpdateApiRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::apigateway::v1::Api > > | A |
DeleteApi(std::string const &, Options)
Deletes a single Api.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. Resource name of the form: |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::apigateway::v1::OperationMetadata > > | A |
DeleteApi(google::cloud::apigateway::v1::DeleteApiRequest const &, Options)
Deletes a single Api.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::apigateway::v1::DeleteApiRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::apigateway::v1::OperationMetadata > > | A |
ListApiConfigs(std::string const &, Options)
Lists ApiConfigs in a given project and location.
Parameters | |
---|---|
Name | Description |
parent |
std::string const &
Required. Parent resource of the API Config, of the form: |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::cloud::apigateway::v1::ApiConfig > | a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
ListApiConfigs(google::cloud::apigateway::v1::ListApiConfigsRequest, Options)
Lists ApiConfigs in a given project and location.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::apigateway::v1::ListApiConfigsRequest
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::cloud::apigateway::v1::ApiConfig > | a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
GetApiConfig(std::string const &, Options)
Gets details of a single ApiConfig.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. Resource name of the form: |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::apigateway::v1::ApiConfig > | the result of the RPC. The response message type (google.cloud.apigateway.v1.ApiConfig) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
GetApiConfig(google::cloud::apigateway::v1::GetApiConfigRequest const &, Options)
Gets details of a single ApiConfig.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::apigateway::v1::GetApiConfigRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::apigateway::v1::ApiConfig > | the result of the RPC. The response message type (google.cloud.apigateway.v1.ApiConfig) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
CreateApiConfig(std::string const &, google::cloud::apigateway::v1::ApiConfig const &, std::string const &, Options)
Creates a new ApiConfig in a given project and location.
Parameters | |
---|---|
Name | Description |
parent |
std::string const &
Required. Parent resource of the API Config, of the form: |
api_config |
google::cloud::apigateway::v1::ApiConfig const &
Required. API resource. |
api_config_id |
std::string const &
Required. Identifier to assign to the API Config. Must be unique within scope of the parent resource. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::apigateway::v1::ApiConfig > > | A |
CreateApiConfig(google::cloud::apigateway::v1::CreateApiConfigRequest const &, Options)
Creates a new ApiConfig in a given project and location.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::apigateway::v1::CreateApiConfigRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::apigateway::v1::ApiConfig > > | A |
UpdateApiConfig(google::cloud::apigateway::v1::ApiConfig const &, google::protobuf::FieldMask const &, Options)
Updates the parameters of a single ApiConfig.
Parameters | |
---|---|
Name | Description |
api_config |
google::cloud::apigateway::v1::ApiConfig const &
Required. API Config resource. |
update_mask |
google::protobuf::FieldMask const &
Field mask is used to specify the fields to be overwritten in the ApiConfig resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::apigateway::v1::ApiConfig > > | A |
UpdateApiConfig(google::cloud::apigateway::v1::UpdateApiConfigRequest const &, Options)
Updates the parameters of a single ApiConfig.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::apigateway::v1::UpdateApiConfigRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::apigateway::v1::ApiConfig > > | A |
DeleteApiConfig(std::string const &, Options)
Deletes a single ApiConfig.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. Resource name of the form: |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::apigateway::v1::OperationMetadata > > | A |
DeleteApiConfig(google::cloud::apigateway::v1::DeleteApiConfigRequest const &, Options)
Deletes a single ApiConfig.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::apigateway::v1::DeleteApiConfigRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::apigateway::v1::OperationMetadata > > | A |