UptimeCheckServiceClient(*, credentials: Optional[google.auth.credentials.Credentials] = None, transport: Optional[Union[str, google.cloud.monitoring_v3.services.uptime_check_service.transports.base.UptimeCheckServiceTransport]] = None, client_options: Optional[google.api_core.client_options.ClientOptions] = None, client_info: google.api_core.gapic_v1.client_info.ClientInfo = <google.api_core.gapic_v1.client_info.ClientInfo object>)
The UptimeCheckService API is used to manage (list, create, delete, edit) Uptime check configurations in the Stackdriver Monitoring product. An Uptime check is a piece of configuration that determines which resources and services to monitor for availability. These configurations can also be configured interactively by navigating to the Cloud Console, selecting the appropriate project, clicking on "Monitoring" on the left-hand side to navigate to Stackdriver, and then clicking on "Uptime".
Properties
transport
Returns the transport used by the client instance.
Returns | |
---|---|
Type | Description |
UptimeCheckServiceTransport | The transport used by the client instance. |
Methods
UptimeCheckServiceClient
UptimeCheckServiceClient(*, credentials: Optional[google.auth.credentials.Credentials] = None, transport: Optional[Union[str, google.cloud.monitoring_v3.services.uptime_check_service.transports.base.UptimeCheckServiceTransport]] = None, client_options: Optional[google.api_core.client_options.ClientOptions] = None, client_info: google.api_core.gapic_v1.client_info.ClientInfo = <google.api_core.gapic_v1.client_info.ClientInfo object>)
Instantiates the uptime check service client.
Parameters | |
---|---|
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, UptimeCheckServiceTransport]
The transport to use. If set to None, a transport is chosen automatically. |
client_options |
google.api_core.client_options.ClientOptions
Custom options for the client. It won't take effect if a |
client_info |
google.api_core.gapic_v1.client_info.ClientInfo
The client info used to send a user-agent string along with API requests. If |
Exceptions | |
---|---|
Type | Description |
google.auth.exceptions.MutualTLSChannelError | If mutual TLS transport creation failed for any reason. |
__exit__
__exit__(type, value, traceback)
Releases underlying transport's resources.
common_billing_account_path
common_billing_account_path(billing_account: str)
Returns a fully-qualified billing_account string.
common_folder_path
common_folder_path(folder: str)
Returns a fully-qualified folder string.
common_location_path
common_location_path(project: str, location: str)
Returns a fully-qualified location string.
common_organization_path
common_organization_path(organization: str)
Returns a fully-qualified organization string.
common_project_path
common_project_path(project: str)
Returns a fully-qualified project string.
create_uptime_check_config
create_uptime_check_config(request: Optional[Union[google.cloud.monitoring_v3.types.uptime_service.CreateUptimeCheckConfigRequest, dict]] = None, *, parent: Optional[str] = None, uptime_check_config: Optional[google.cloud.monitoring_v3.types.uptime.UptimeCheckConfig] = None, retry: Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault] = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())
Creates a new Uptime check configuration.
Parameters | |
---|---|
Name | Description |
request |
Union[google.cloud.monitoring_v3.types.CreateUptimeCheckConfigRequest, dict]
The request object. The protocol for the |
parent |
str
Required. The |
uptime_check_config |
google.cloud.monitoring_v3.types.UptimeCheckConfig
Required. The new Uptime check configuration. This corresponds to the |
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. |
Returns | |
---|---|
Type | Description |
google.cloud.monitoring_v3.types.UptimeCheckConfig | This message configures which resources and services to monitor for availability. |
delete_uptime_check_config
delete_uptime_check_config(request: Optional[Union[google.cloud.monitoring_v3.types.uptime_service.DeleteUptimeCheckConfigRequest, dict]] = None, *, name: Optional[str] = None, retry: Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault] = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())
Deletes an Uptime check configuration. Note that this method will fail if the Uptime check configuration is referenced by an alert policy or other dependent configs that would be rendered invalid by the deletion.
Parameters | |
---|---|
Name | Description |
request |
Union[google.cloud.monitoring_v3.types.DeleteUptimeCheckConfigRequest, dict]
The request object. The protocol for the |
name |
str
Required. The Uptime check configuration to delete. The format is: :: projects/[PROJECT_ID_OR_NUMBER]/uptimeCheckConfigs/[UPTIME_CHECK_ID] This corresponds to the |
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. |
from_service_account_file
from_service_account_file(filename: str, *args, **kwargs)
Creates an instance of this client using the provided credentials file.
Parameter | |
---|---|
Name | Description |
filename |
str
The path to the service account private key json file. |
Returns | |
---|---|
Type | Description |
UptimeCheckServiceClient | The constructed client. |
from_service_account_info
from_service_account_info(info: dict, *args, **kwargs)
Creates an instance of this client using the provided credentials info.
Parameter | |
---|---|
Name | Description |
info |
dict
The service account private key info. |
Returns | |
---|---|
Type | Description |
UptimeCheckServiceClient | The constructed client. |
from_service_account_json
from_service_account_json(filename: str, *args, **kwargs)
Creates an instance of this client using the provided credentials file.
Parameter | |
---|---|
Name | Description |
filename |
str
The path to the service account private key json file. |
Returns | |
---|---|
Type | Description |
UptimeCheckServiceClient | The constructed client. |
get_uptime_check_config
get_uptime_check_config(request: Optional[Union[google.cloud.monitoring_v3.types.uptime_service.GetUptimeCheckConfigRequest, dict]] = None, *, name: Optional[str] = None, retry: Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault] = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())
Gets a single Uptime check configuration.
Parameters | |
---|---|
Name | Description |
request |
Union[google.cloud.monitoring_v3.types.GetUptimeCheckConfigRequest, dict]
The request object. The protocol for the |
name |
str
Required. The Uptime check configuration to retrieve. The format is: :: projects/[PROJECT_ID_OR_NUMBER]/uptimeCheckConfigs/[UPTIME_CHECK_ID] This corresponds to the |
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. |
Returns | |
---|---|
Type | Description |
google.cloud.monitoring_v3.types.UptimeCheckConfig | This message configures which resources and services to monitor for availability. |
list_uptime_check_configs
list_uptime_check_configs(request: Optional[Union[google.cloud.monitoring_v3.types.uptime_service.ListUptimeCheckConfigsRequest, dict]] = None, *, parent: Optional[str] = None, retry: Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault] = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())
Lists the existing valid Uptime check configurations for the project (leaving out any invalid configurations).
Parameters | |
---|---|
Name | Description |
request |
Union[google.cloud.monitoring_v3.types.ListUptimeCheckConfigsRequest, dict]
The request object. The protocol for the |
parent |
str
Required. The |
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. |
Returns | |
---|---|
Type | Description |
google.cloud.monitoring_v3.services.uptime_check_service.pagers.ListUptimeCheckConfigsPager | The protocol for the ListUptimeCheckConfigs response. Iterating over this object will yield results and resolve additional pages automatically. |
list_uptime_check_ips
list_uptime_check_ips(request: Optional[Union[google.cloud.monitoring_v3.types.uptime_service.ListUptimeCheckIpsRequest, dict]] = None, *, retry: Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault] = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())
Returns the list of IP addresses that checkers run from
Parameters | |
---|---|
Name | Description |
request |
Union[google.cloud.monitoring_v3.types.ListUptimeCheckIpsRequest, dict]
The request object. The protocol for the |
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. |
Returns | |
---|---|
Type | Description |
google.cloud.monitoring_v3.services.uptime_check_service.pagers.ListUptimeCheckIpsPager | The protocol for the ListUptimeCheckIps response. Iterating over this object will yield results and resolve additional pages automatically. |
parse_common_billing_account_path
parse_common_billing_account_path(path: str)
Parse a billing_account path into its component segments.
parse_common_folder_path
parse_common_folder_path(path: str)
Parse a folder path into its component segments.
parse_common_location_path
parse_common_location_path(path: str)
Parse a location path into its component segments.
parse_common_organization_path
parse_common_organization_path(path: str)
Parse a organization path into its component segments.
parse_common_project_path
parse_common_project_path(path: str)
Parse a project path into its component segments.
parse_uptime_check_config_path
parse_uptime_check_config_path(path: str)
Parses a uptime_check_config path into its component segments.
update_uptime_check_config
update_uptime_check_config(request: Optional[Union[google.cloud.monitoring_v3.types.uptime_service.UpdateUptimeCheckConfigRequest, dict]] = None, *, uptime_check_config: Optional[google.cloud.monitoring_v3.types.uptime.UptimeCheckConfig] = None, retry: Union[google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault] = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())
Updates an Uptime check configuration. You can either replace
the entire configuration with a new one or replace only certain
fields in the current configuration by specifying the fields to
be updated via updateMask
. Returns the updated
configuration.
Parameters | |
---|---|
Name | Description |
request |
Union[google.cloud.monitoring_v3.types.UpdateUptimeCheckConfigRequest, dict]
The request object. The protocol for the |
uptime_check_config |
google.cloud.monitoring_v3.types.UptimeCheckConfig
Required. If an |
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. |
Returns | |
---|---|
Type | Description |
google.cloud.monitoring_v3.types.UptimeCheckConfig | This message configures which resources and services to monitor for availability. |
uptime_check_config_path
uptime_check_config_path(project: str, uptime_check_config: str)
Returns a fully-qualified uptime_check_config string.