Class ServicesClient (0.7.0)

publicclass ServicesClientimplementsBackgroundResource

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
ServiceNamename=ServiceName.of("[PROJECT]","[LOCATION]","[SERVICE]");
Serviceresponse=servicesClient.getService(name);
}

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
ServicesSettingsservicesSettings=
ServicesSettings.newBuilder()
.setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
.build();
ServicesClientservicesClient=ServicesClient.create(servicesSettings);

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
ServicesSettingsservicesSettings=
ServicesSettings.newBuilder().setEndpoint(myEndpoint).build();
ServicesClientservicesClient=ServicesClient.create(servicesSettings);

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
ServicesSettingsservicesSettings=ServicesSettings.newHttpJsonBuilder().build();
ServicesClientservicesClient=ServicesClient.create(servicesSettings);

publicstaticfinalServicesClientcreate()

publicstaticfinalServicesClientcreate(ServicesSettingssettings)

publicstaticfinalServicesClientcreate(ServicesStubstub)

protectedServicesClient(ServicesSettingssettings)

protectedServicesClient(ServicesStubstub)

publicbooleanawaitTermination(longduration,TimeUnitunit)

publicfinalvoidclose()

publicfinalOperationFuture<Service,Service>createServiceAsync(CreateServiceRequestrequest)

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
CreateServiceRequestrequest=
CreateServiceRequest.newBuilder()
.setParent(LocationName.of("[PROJECT]","[LOCATION]").toString())
.setService(Service.newBuilder().build())
.setServiceId("serviceId-194185552")
.setValidateOnly(true)
.build();
Serviceresponse=servicesClient.createServiceAsync(request).get();
}

publicfinalOperationFuture<Service,Service>createServiceAsync(LocationNameparent,Serviceservice,StringserviceId)

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
LocationNameparent=LocationName.of("[PROJECT]","[LOCATION]");
Serviceservice=Service.newBuilder().build();
StringserviceId="serviceId-194185552";
Serviceresponse=servicesClient.createServiceAsync(parent,service,serviceId).get();
}

publicfinalOperationFuture<Service,Service>createServiceAsync(Stringparent,Serviceservice,StringserviceId)

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
Stringparent=LocationName.of("[PROJECT]","[LOCATION]").toString();
Serviceservice=Service.newBuilder().build();
StringserviceId="serviceId-194185552";
Serviceresponse=servicesClient.createServiceAsync(parent,service,serviceId).get();
}

publicfinalUnaryCallable<CreateServiceRequest,Operation>createServiceCallable()

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
CreateServiceRequestrequest=
CreateServiceRequest.newBuilder()
.setParent(LocationName.of("[PROJECT]","[LOCATION]").toString())
.setService(Service.newBuilder().build())
.setServiceId("serviceId-194185552")
.setValidateOnly(true)
.build();
ApiFuture<Operation>future=servicesClient.createServiceCallable().futureCall(request);
// Do something.
Operationresponse=future.get();
}

publicfinalOperationCallable<CreateServiceRequest,Service,Service>createServiceOperationCallable()

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
CreateServiceRequestrequest=
CreateServiceRequest.newBuilder()
.setParent(LocationName.of("[PROJECT]","[LOCATION]").toString())
.setService(Service.newBuilder().build())
.setServiceId("serviceId-194185552")
.setValidateOnly(true)
.build();
OperationFuture<Service,Service>future=
servicesClient.createServiceOperationCallable().futureCall(request);
// Do something.
Serviceresponse=future.get();
}

publicfinalOperationFuture<Service,Service>deleteServiceAsync(DeleteServiceRequestrequest)

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
DeleteServiceRequestrequest=
DeleteServiceRequest.newBuilder()
.setName(ServiceName.of("[PROJECT]","[LOCATION]","[SERVICE]").toString())
.setValidateOnly(true)
.setEtag("etag3123477")
.build();
Serviceresponse=servicesClient.deleteServiceAsync(request).get();
}

publicfinalOperationFuture<Service,Service>deleteServiceAsync(ServiceNamename)

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
ServiceNamename=ServiceName.of("[PROJECT]","[LOCATION]","[SERVICE]");
Serviceresponse=servicesClient.deleteServiceAsync(name).get();
}

publicfinalOperationFuture<Service,Service>deleteServiceAsync(Stringname)

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
Stringname=ServiceName.of("[PROJECT]","[LOCATION]","[SERVICE]").toString();
Serviceresponse=servicesClient.deleteServiceAsync(name).get();
}

publicfinalUnaryCallable<DeleteServiceRequest,Operation>deleteServiceCallable()

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
DeleteServiceRequestrequest=
DeleteServiceRequest.newBuilder()
.setName(ServiceName.of("[PROJECT]","[LOCATION]","[SERVICE]").toString())
.setValidateOnly(true)
.setEtag("etag3123477")
.build();
ApiFuture<Operation>future=servicesClient.deleteServiceCallable().futureCall(request);
// Do something.
Operationresponse=future.get();
}

publicfinalOperationCallable<DeleteServiceRequest,Service,Service>deleteServiceOperationCallable()

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
DeleteServiceRequestrequest=
DeleteServiceRequest.newBuilder()
.setName(ServiceName.of("[PROJECT]","[LOCATION]","[SERVICE]").toString())
.setValidateOnly(true)
.setEtag("etag3123477")
.build();
OperationFuture<Service,Service>future=
servicesClient.deleteServiceOperationCallable().futureCall(request);
// Do something.
Serviceresponse=future.get();
}

publicfinalOperationsClientgetHttpJsonOperationsClient()

publicfinalPolicygetIamPolicy(GetIamPolicyRequestrequest)

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
GetIamPolicyRequestrequest=
GetIamPolicyRequest.newBuilder()
.setResource(ServiceName.of("[PROJECT]","[LOCATION]","[SERVICE]").toString())
.setOptions(GetPolicyOptions.newBuilder().build())
.build();
Policyresponse=servicesClient.getIamPolicy(request);
}

publicfinalUnaryCallable<GetIamPolicyRequest,Policy>getIamPolicyCallable()

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
GetIamPolicyRequestrequest=
GetIamPolicyRequest.newBuilder()
.setResource(ServiceName.of("[PROJECT]","[LOCATION]","[SERVICE]").toString())
.setOptions(GetPolicyOptions.newBuilder().build())
.build();
ApiFuture<Policy>future=servicesClient.getIamPolicyCallable().futureCall(request);
// Do something.
Policyresponse=future.get();
}

publicfinalOperationsClientgetOperationsClient()

publicfinalServicegetService(GetServiceRequestrequest)

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
GetServiceRequestrequest=
GetServiceRequest.newBuilder()
.setName(ServiceName.of("[PROJECT]","[LOCATION]","[SERVICE]").toString())
.build();
Serviceresponse=servicesClient.getService(request);
}

publicfinalServicegetService(ServiceNamename)

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
ServiceNamename=ServiceName.of("[PROJECT]","[LOCATION]","[SERVICE]");
Serviceresponse=servicesClient.getService(name);
}

publicfinalServicegetService(Stringname)

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
Stringname=ServiceName.of("[PROJECT]","[LOCATION]","[SERVICE]").toString();
Serviceresponse=servicesClient.getService(name);
}

publicfinalUnaryCallable<GetServiceRequest,Service>getServiceCallable()

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
GetServiceRequestrequest=
GetServiceRequest.newBuilder()
.setName(ServiceName.of("[PROJECT]","[LOCATION]","[SERVICE]").toString())
.build();
ApiFuture<Service>future=servicesClient.getServiceCallable().futureCall(request);
// Do something.
Serviceresponse=future.get();
}

publicfinalServicesSettingsgetSettings()

publicServicesStubgetStub()

publicbooleanisShutdown()

publicbooleanisTerminated()

publicfinalServicesClient.ListServicesPagedResponselistServices(ListServicesRequestrequest)

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
ListServicesRequestrequest=
ListServicesRequest.newBuilder()
.setParent(LocationName.of("[PROJECT]","[LOCATION]").toString())
.setPageSize(883849137)
.setPageToken("pageToken873572522")
.setShowDeleted(true)
.build();
for(Serviceelement:servicesClient.listServices(request).iterateAll()){
// doThingsWith(element);
}
}

publicfinalServicesClient.ListServicesPagedResponselistServices(LocationNameparent)

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
LocationNameparent=LocationName.of("[PROJECT]","[LOCATION]");
for(Serviceelement:servicesClient.listServices(parent).iterateAll()){
// doThingsWith(element);
}
}

publicfinalServicesClient.ListServicesPagedResponselistServices(Stringparent)

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
Stringparent=LocationName.of("[PROJECT]","[LOCATION]").toString();
for(Serviceelement:servicesClient.listServices(parent).iterateAll()){
// doThingsWith(element);
}
}

publicfinalUnaryCallable<ListServicesRequest,ListServicesResponse>listServicesCallable()

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
ListServicesRequestrequest=
ListServicesRequest.newBuilder()
.setParent(LocationName.of("[PROJECT]","[LOCATION]").toString())
.setPageSize(883849137)
.setPageToken("pageToken873572522")
.setShowDeleted(true)
.build();
while(true){
ListServicesResponseresponse=servicesClient.listServicesCallable().call(request);
for(Serviceelement:response.getServicesList()){
// doThingsWith(element);
}
StringnextPageToken=response.getNextPageToken();
if(!Strings.isNullOrEmpty(nextPageToken)){
request=request.toBuilder().setPageToken(nextPageToken).build();
}else{
break;
}
}
}

publicfinalUnaryCallable<ListServicesRequest,ServicesClient.ListServicesPagedResponse>listServicesPagedCallable()

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
ListServicesRequestrequest=
ListServicesRequest.newBuilder()
.setParent(LocationName.of("[PROJECT]","[LOCATION]").toString())
.setPageSize(883849137)
.setPageToken("pageToken873572522")
.setShowDeleted(true)
.build();
ApiFuture<Service>future=servicesClient.listServicesPagedCallable().futureCall(request);
// Do something.
for(Serviceelement:future.get().iterateAll()){
// doThingsWith(element);
}
}

publicfinalPolicysetIamPolicy(SetIamPolicyRequestrequest)

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
SetIamPolicyRequestrequest=
SetIamPolicyRequest.newBuilder()
.setResource(ServiceName.of("[PROJECT]","[LOCATION]","[SERVICE]").toString())
.setPolicy(Policy.newBuilder().build())
.setUpdateMask(FieldMask.newBuilder().build())
.build();
Policyresponse=servicesClient.setIamPolicy(request);
}

publicfinalUnaryCallable<SetIamPolicyRequest,Policy>setIamPolicyCallable()

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
SetIamPolicyRequestrequest=
SetIamPolicyRequest.newBuilder()
.setResource(ServiceName.of("[PROJECT]","[LOCATION]","[SERVICE]").toString())
.setPolicy(Policy.newBuilder().build())
.setUpdateMask(FieldMask.newBuilder().build())
.build();
ApiFuture<Policy>future=servicesClient.setIamPolicyCallable().futureCall(request);
// Do something.
Policyresponse=future.get();
}

publicvoidshutdown()

publicvoidshutdownNow()

publicfinalTestIamPermissionsResponsetestIamPermissions(TestIamPermissionsRequestrequest)

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
TestIamPermissionsRequestrequest=
TestIamPermissionsRequest.newBuilder()
.setResource(ServiceName.of("[PROJECT]","[LOCATION]","[SERVICE]").toString())
.addAllPermissions(newArrayList<String>())
.build();
TestIamPermissionsResponseresponse=servicesClient.testIamPermissions(request);
}

publicfinalUnaryCallable<TestIamPermissionsRequest,TestIamPermissionsResponse>testIamPermissionsCallable()

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
TestIamPermissionsRequestrequest=
TestIamPermissionsRequest.newBuilder()
.setResource(ServiceName.of("[PROJECT]","[LOCATION]","[SERVICE]").toString())
.addAllPermissions(newArrayList<String>())
.build();
ApiFuture<TestIamPermissionsResponse>future=
servicesClient.testIamPermissionsCallable().futureCall(request);
// Do something.
TestIamPermissionsResponseresponse=future.get();
}

publicfinalOperationFuture<Service,Service>updateServiceAsync(Serviceservice)

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
Serviceservice=Service.newBuilder().build();
Serviceresponse=servicesClient.updateServiceAsync(service).get();
}

publicfinalOperationFuture<Service,Service>updateServiceAsync(UpdateServiceRequestrequest)

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
UpdateServiceRequestrequest=
UpdateServiceRequest.newBuilder()
.setService(Service.newBuilder().build())
.setValidateOnly(true)
.setAllowMissing(true)
.build();
Serviceresponse=servicesClient.updateServiceAsync(request).get();
}

publicfinalUnaryCallable<UpdateServiceRequest,Operation>updateServiceCallable()

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
UpdateServiceRequestrequest=
UpdateServiceRequest.newBuilder()
.setService(Service.newBuilder().build())
.setValidateOnly(true)
.setAllowMissing(true)
.build();
ApiFuture<Operation>future=servicesClient.updateServiceCallable().futureCall(request);
// Do something.
Operationresponse=future.get();
}

publicfinalOperationCallable<UpdateServiceRequest,Service,Service>updateServiceOperationCallable()

// This snippet has been automatically generated and should be regarded as a code template only.
// It will require modifications to work:
// - It may require correct/in-range values for request initialization.
// - It may require specifying regional endpoints when creating the service client as shown in
// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
try(ServicesClientservicesClient=ServicesClient.create()){
UpdateServiceRequestrequest=
UpdateServiceRequest.newBuilder()
.setService(Service.newBuilder().build())
.setValidateOnly(true)
.setAllowMissing(true)
.build();
OperationFuture<Service,Service>future=
servicesClient.updateServiceOperationCallable().futureCall(request);
// Do something.
Serviceresponse=future.get();
}