Class ApiGatewayServiceAsyncClient (0.1.0)

ApiGatewayServiceAsyncClient(*, credentials: google.auth.credentials.Credentials = None, transport: Union[str, google.cloud.apigateway_v1.services.api_gateway_service.transports.base.ApiGatewayServiceTransport] = 'grpc_asyncio', client_options: <module 'google.api_core.client_options' from'/workspace/python-api-gateway/.nox/docfx/lib/python3.9/site-packages/google/api_core/client_options.py'> = None, client_info: google.api_core.gapic_v1.client_info.ClientInfo = <google.api_core.gapic_v1.client_info.ClientInfo object>)

Type Description

ApiGatewayServiceTransport The transport used by the client instance.

ApiGatewayServiceAsyncClient(*, credentials: google.auth.credentials.Credentials = None, transport: Union[str, google.cloud.apigateway_v1.services.api_gateway_service.transports.base.ApiGatewayServiceTransport] = 'grpc_asyncio', client_options: <module 'google.api_core.client_options' from'/workspace/python-api-gateway/.nox/docfx/lib/python3.9/site-packages/google/api_core/client_options.py'> = None, client_info: google.api_core.gapic_v1.client_info.ClientInfo = <google.api_core.gapic_v1.client_info.ClientInfo object>)

Name Description

credentials Optional[google.auth.credentials.Credentials]

The authorization credentials to attach to requests. These credentials identify the application to the service; if none are specified, the client will attempt to ascertain the credentials from the environment.

transport Union[str, .ApiGatewayServiceTransport]

The transport to use. If set to None, a transport is chosen automatically.

client_options ClientOptions

Custom options for the client. It won't take effect if a transport instance is provided. (1) The api_endpoint property can be used to override the default endpoint provided by the client. GOOGLE_API_USE_MTLS_ENDPOINT environment variable can also be used to override the endpoint: "always" (always use the default mTLS endpoint), "never" (always use the default regular endpoint) and "auto" (auto switch to the default mTLS endpoint if client certificate is present, this is the default value). However, the api_endpoint property takes precedence if provided. (2) If GOOGLE_API_USE_CLIENT_CERTIFICATE environment variable is "true", then the client_cert_source property can be used to provide client certificate for mutual TLS transport. If not provided, the default SSL client certificate will be used if present. If GOOGLE_API_USE_CLIENT_CERTIFICATE is "false" or not set, no client certificate will be used.

Type Description

google.auth.exceptions.MutualTlsChannelError If mutual TLS transport creation failed for any reason.

api_config_path(project: str, api: str, api_config: str)

api_path(project: str, api: str)

common_billing_account_path(billing_account: str)

common_folder_path(folder: str)

common_location_path(project: str, location: str)

common_organization_path(organization: str)

common_project_path(project: str)

create_api(request: Optional[google.cloud.apigateway_v1.types.apigateway.CreateApiRequest] = None, *, parent: Optional[str] = None, api: Optional[google.cloud.apigateway_v1.types.apigateway.Api] = None, api_id: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request CreateApiRequest

The request object. Request message for ApiGatewayService.CreateApi

parent str

Required. Parent resource of the API, of the form: projects/*/locations/global This corresponds to the parent field on the request instance; if request is provided, this should not be set.

api Api

Required. API resource. This corresponds to the api field on the request instance; if request is provided, this should not be set.

api_id str

Required. Identifier to assign to the API. Must be unique within scope of the parent resource. This corresponds to the api_id field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.api_core.operation_async.AsyncOperation An object representing a long-running operation. The result type for the operation will be Api An API that can be served by one or more Gateways.

create_api_config(request: Optional[google.cloud.apigateway_v1.types.apigateway.CreateApiConfigRequest] = None, *, parent: Optional[str] = None, api_config: Optional[google.cloud.apigateway_v1.types.apigateway.ApiConfig] = None, api_config_id: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request CreateApiConfigRequest

The request object. Request message for ApiGatewayService.CreateApiConfig

parent str

Required. Parent resource of the API Config, of the form: projects//locations/global/apis/ This corresponds to the parent field on the request instance; if request is provided, this should not be set.

api_config ApiConfig

Required. API resource. This corresponds to the api_config field on the request instance; if request is provided, this should not be set.

api_config_id str

Required. Identifier to assign to the API Config. Must be unique within scope of the parent resource. This corresponds to the api_config_id field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.api_core.operation_async.AsyncOperation An object representing a long-running operation. The result type for the operation will be ApiConfig An API Configuration is a combination of settings for both the Managed Service and Gateways serving this API Config.

create_gateway(request: Optional[google.cloud.apigateway_v1.types.apigateway.CreateGatewayRequest] = None, *, parent: Optional[str] = None, gateway: Optional[google.cloud.apigateway_v1.types.apigateway.Gateway] = None, gateway_id: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request CreateGatewayRequest

The request object. Request message for ApiGatewayService.CreateGateway

parent str

Required. Parent resource of the Gateway, of the form: projects//locations/ This corresponds to the parent field on the request instance; if request is provided, this should not be set.

gateway Gateway

Required. Gateway resource. This corresponds to the gateway field on the request instance; if request is provided, this should not be set.

gateway_id str

Required. Identifier to assign to the Gateway. Must be unique within scope of the parent resource. This corresponds to the gateway_id field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.api_core.operation_async.AsyncOperation An object representing a long-running operation. The result type for the operation will be Gateway A Gateway is an API-aware HTTP proxy. It performs API-Method and/or API-Consumer specific actions based on an API Config such as authentication, policy enforcement, and backend selection.

delete_api(request: Optional[google.cloud.apigateway_v1.types.apigateway.DeleteApiRequest] = None, *, name: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request DeleteApiRequest

The request object. Request message for ApiGatewayService.DeleteApi

name str

Required. Resource name of the form: projects//locations/global/apis/ This corresponds to the name field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.api_core.operation_async.AsyncOperation An object representing a long-running operation. The result type for the operation will be google.protobuf.empty_pb2.Empty 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); } The JSON representation for Empty is empty JSON object {}.

delete_api_config(request: Optional[google.cloud.apigateway_v1.types.apigateway.DeleteApiConfigRequest] = None, *, name: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request DeleteApiConfigRequest

The request object. Request message for ApiGatewayService.DeleteApiConfig

name str

Required. Resource name of the form: projects//locations/global/apis//configs/* This corresponds to the name field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.api_core.operation_async.AsyncOperation An object representing a long-running operation. The result type for the operation will be google.protobuf.empty_pb2.Empty 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); } The JSON representation for Empty is empty JSON object {}.

delete_gateway(request: Optional[google.cloud.apigateway_v1.types.apigateway.DeleteGatewayRequest] = None, *, name: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request DeleteGatewayRequest

The request object. Request message for ApiGatewayService.DeleteGateway

name str

Required. Resource name of the form: projects//locations//gateways/* This corresponds to the name field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.api_core.operation_async.AsyncOperation An object representing a long-running operation. The result type for the operation will be google.protobuf.empty_pb2.Empty 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); } The JSON representation for Empty is empty JSON object {}.

from_service_account_file(filename: str, *args, **kwargs)

Name Description

filename str

The path to the service account private key json file.

Type Description

ApiGatewayServiceAsyncClient The constructed client.

from_service_account_info(info: dict, *args, **kwargs)

Name Description

info dict

The service account private key info.

Type Description

ApiGatewayServiceAsyncClient The constructed client.

from_service_account_json(filename: str, *args, **kwargs)

Name Description

filename str

The path to the service account private key json file.

Type Description

ApiGatewayServiceAsyncClient The constructed client.

gateway_path(project: str, location: str, gateway: str)

get_api(request: Optional[google.cloud.apigateway_v1.types.apigateway.GetApiRequest] = None, *, name: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request GetApiRequest

The request object. Request message for ApiGatewayService.GetApi

name str

Required. Resource name of the form: projects//locations/global/apis/ This corresponds to the name field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.cloud.apigateway_v1.types.Api An API that can be served by one or more Gateways.

get_api_config(request: Optional[google.cloud.apigateway_v1.types.apigateway.GetApiConfigRequest] = None, *, name: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request GetApiConfigRequest

The request object. Request message for ApiGatewayService.GetApiConfig

name str

Required. Resource name of the form: projects//locations/global/apis//configs/* This corresponds to the name field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.cloud.apigateway_v1.types.ApiConfig An API Configuration is a combination of settings for both the Managed Service and Gateways serving this API Config.

get_gateway(request: Optional[google.cloud.apigateway_v1.types.apigateway.GetGatewayRequest] = None, *, name: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request GetGatewayRequest

The request object. Request message for ApiGatewayService.GetGateway

name str

Required. Resource name of the form: projects//locations//gateways/* This corresponds to the name field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.cloud.apigateway_v1.types.Gateway A Gateway is an API-aware HTTP proxy. It performs API-Method and/or API- Consumer specific actions based on an API Config such as authentication, policy enforcement, and backend selection.

get_transport_class()

list_api_configs(request: Optional[google.cloud.apigateway_v1.types.apigateway.ListApiConfigsRequest] = None, *, parent: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request ListApiConfigsRequest

The request object. Request message for ApiGatewayService.ListApiConfigs

parent str

Required. Parent resource of the API Config, of the form: projects//locations/global/apis/ This corresponds to the parent field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.cloud.apigateway_v1.services.api_gateway_service.pagers.ListApiConfigsAsyncPager Response message for ApiGatewayService.ListApiConfigs Iterating over this object will yield results and resolve additional pages automatically.

list_apis(request: Optional[google.cloud.apigateway_v1.types.apigateway.ListApisRequest] = None, *, parent: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request ListApisRequest

The request object. Request message for ApiGatewayService.ListApis

parent str

Required. Parent resource of the API, of the form: projects/*/locations/global This corresponds to the parent field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.cloud.apigateway_v1.services.api_gateway_service.pagers.ListApisAsyncPager Response message for ApiGatewayService.ListApis Iterating over this object will yield results and resolve additional pages automatically.

list_gateways(request: Optional[google.cloud.apigateway_v1.types.apigateway.ListGatewaysRequest] = None, *, parent: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request ListGatewaysRequest

The request object. Request message for ApiGatewayService.ListGateways

parent str

Required. Parent resource of the Gateway, of the form: projects//locations/ This corresponds to the parent field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.cloud.apigateway_v1.services.api_gateway_service.pagers.ListGatewaysAsyncPager Response message for ApiGatewayService.ListGateways Iterating over this object will yield results and resolve additional pages automatically.

managed_service_path(service: str)

parse_api_config_path(path: str)

parse_api_path(path: str)

parse_common_billing_account_path(path: str)

parse_common_folder_path(path: str)

parse_common_location_path(path: str)

parse_common_organization_path(path: str)

parse_common_project_path(path: str)

parse_gateway_path(path: str)

parse_managed_service_path(path: str)

parse_service_account_path(path: str)

parse_service_path(path: str)

service_account_path(project: str, service_account: str)

service_path(service: str, config: str)

update_api(request: Optional[google.cloud.apigateway_v1.types.apigateway.UpdateApiRequest] = None, *, api: Optional[google.cloud.apigateway_v1.types.apigateway.Api] = None, update_mask: Optional[google.protobuf.field_mask_pb2.FieldMask] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request UpdateApiRequest

The request object. Request message for ApiGatewayService.UpdateApi

api Api

Required. API resource. This corresponds to the api field on the request instance; if request is provided, this should not be set.

update_mask google.protobuf.field_mask_pb2.FieldMask

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. This corresponds to the update_mask field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.api_core.operation_async.AsyncOperation An object representing a long-running operation. The result type for the operation will be Api An API that can be served by one or more Gateways.

update_api_config(request: Optional[google.cloud.apigateway_v1.types.apigateway.UpdateApiConfigRequest] = None, *, api_config: Optional[google.cloud.apigateway_v1.types.apigateway.ApiConfig] = None, update_mask: Optional[google.protobuf.field_mask_pb2.FieldMask] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request UpdateApiConfigRequest

The request object. Request message for ApiGatewayService.UpdateApiConfig

api_config ApiConfig

Required. API Config resource. This corresponds to the api_config field on the request instance; if request is provided, this should not be set.

update_mask google.protobuf.field_mask_pb2.FieldMask

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. This corresponds to the update_mask field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.api_core.operation_async.AsyncOperation An object representing a long-running operation. The result type for the operation will be ApiConfig An API Configuration is a combination of settings for both the Managed Service and Gateways serving this API Config.

update_gateway(request: Optional[google.cloud.apigateway_v1.types.apigateway.UpdateGatewayRequest] = None, *, gateway: Optional[google.cloud.apigateway_v1.types.apigateway.Gateway] = None, update_mask: Optional[google.protobuf.field_mask_pb2.FieldMask] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request UpdateGatewayRequest

The request object. Request message for ApiGatewayService.UpdateGateway

gateway Gateway

Required. Gateway resource. This corresponds to the gateway field on the request instance; if request is provided, this should not be set.

update_mask google.protobuf.field_mask_pb2.FieldMask

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. This corresponds to the update_mask field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.api_core.operation_async.AsyncOperation An object representing a long-running operation. The result type for the operation will be Gateway A Gateway is an API-aware HTTP proxy. It performs API-Method and/or API-Consumer specific actions based on an API Config such as authentication, policy enforcement, and backend selection.