com.google.api.services.servicecontrol.v2

Class ServiceControl.Services

java.lang.Object

com.google.api.services.servicecontrol.v2.ServiceControl.Services

Enclosing class:

ServiceControl

public class ServiceControl.Services
extends Object

The "services" collection of methods.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	ServiceControl.Services.Check
class	ServiceControl.Services.Report

Constructor Summary

Constructors

Constructor and Description
Services()

Method Summary

Modifier and Type	Method and Description
ServiceControl.Services.Check	check(String serviceName, CheckRequest content) This method provides admission control for services that are integrated with [Service Infrastructure](https://cloud.google.com/service-infrastructure).
ServiceControl.Services.Report	report(String serviceName, ReportRequest content) This method provides telemetry reporting for services that are integrated with [Service Infrastructure](https://cloud.google.com/service-infrastructure).

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Services

public Services()

Method Detail

check

public ServiceControl.Services.Check check(String serviceName,
                                           CheckRequest content)
                                    throws IOException

This method provides admission control for services that are integrated with [Service Infrastructure](https://cloud.google.com/service-infrastructure). It checks whether an operation should be allowed based on the service configuration and relevant policies. It must be called before the operation is executed. For more information, see [Admission Control](https://cloud.google.com/service-infrastructure/docs/admission-control). NOTE: The admission control has an expected policy propagation delay of 60s. The caller **must** not depend on the most recent policy changes. NOTE: The admission control has a hard limit of 1 referenced resources per call. If an operation refers to more than 1 resources, the caller must call the Check method multiple times. This method requires the `servicemanagement.services.check` permission on the specified service. For more information, see [Service Control API Access Control](https://cloud.google.com/service-infrastructure/docs/service-control/access-control). Create a request for the method "services.check". This request holds the parameters needed by the servicecontrol server. After setting any optional parameters, call the AbstractGoogleClientRequest.execute() method to invoke the remote operation.

Parameters:

serviceName - The service name as specified in its service configuration. For example, `"pubsub.googleapis.com"`. See [google.api.Service](https://cloud.google.com/service- management/reference/rpc/google.api#google.api.Service) for the definition of a service name.

content - the CheckRequest

Returns:

the request

Throws:

IOException

report

public ServiceControl.Services.Report report(String serviceName,
                                             ReportRequest content)
                                      throws IOException

This method provides telemetry reporting for services that are integrated with [Service Infrastructure](https://cloud.google.com/service-infrastructure). It reports a list of operations that have occurred on a service. It must be called after the operations have been executed. For more information, see [Telemetry Reporting](https://cloud.google.com/service- infrastructure/docs/telemetry-reporting). NOTE: The telemetry reporting has a hard limit of 100 operations and 1MB per Report call. This method requires the `servicemanagement.services.report` permission on the specified service. For more information, see [Service Control API Access Control](https://cloud.google.com/service-infrastructure/docs/service-control/access-control). Create a request for the method "services.report". This request holds the parameters needed by the servicecontrol server. After setting any optional parameters, call the AbstractGoogleClientRequest.execute() method to invoke the remote operation.

Parameters:

serviceName - The service name as specified in its service configuration. For example, `"pubsub.googleapis.com"`. See [google.api.Service](https://cloud.google.com/service- management/reference/rpc/google.api#google.api.Service) for the definition of a service name.

content - the ReportRequest

Returns:

the request

Throws:

IOException