Package com.google.cloud.config.v1 (0.5.0)

A client to Infrastructure Manager API

The interfaces provided are listed below, along with usage samples.

ConfigClient

Service Description: Infrastructure Manager is a managed service that automates the deployment and management of Google Cloud infrastructure resources.

Sample for ConfigClient:


 // 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 (ConfigClient configClient = ConfigClient.create()) {
   DeploymentName name = DeploymentName.of("[PROJECT]", "[LOCATION]", "[DEPLOYMENT]");
   Deployment response = configClient.getDeployment(name);
 }
 

Classes

ApplyResults

Outputs and artifacts from applying a deployment.

Protobuf type google.cloud.config.v1.ApplyResults

ApplyResults.Builder

Outputs and artifacts from applying a deployment.

Protobuf type google.cloud.config.v1.ApplyResults

ConfigClient

Service Description: Infrastructure Manager is a managed service that automates the deployment and management of Google Cloud infrastructure resources.

This class provides the ability to make remote calls to the backing service through method calls that map to API methods. Sample code to get started:


 // 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 (ConfigClient configClient = ConfigClient.create()) {
   DeploymentName name = DeploymentName.of("[PROJECT]", "[LOCATION]", "[DEPLOYMENT]");
   Deployment response = configClient.getDeployment(name);
 }
 

Note: close() needs to be called on the ConfigClient object to clean up resources such as threads. In the example above, try-with-resources is used, which automatically calls close().

The surface of this class includes several types of Java methods for each of the API's methods:

  1. A "flattened" method. With this type of method, the fields of the request type have been converted into function parameters. It may be the case that not all fields are available as parameters, and not every API method will have a flattened method entry point.
  2. A "request object" method. This type of method only takes one parameter, a request object, which must be constructed before the call. Not every API method will have a request object method.
  3. A "callable" method. This type of method takes no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

See the individual methods for example code.

Many parameters require resource names to be formatted in a particular way. To assist with these names, this class includes a format method for each type of name, and additionally a parse method to extract the individual identifiers contained within names that are returned.

This class can be customized by passing in a custom instance of ConfigSettings to create(). For example:

To customize credentials:


 // 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
 ConfigSettings configSettings =
     ConfigSettings.newBuilder()
         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
         .build();
 ConfigClient configClient = ConfigClient.create(configSettings);
 

To customize the endpoint:


 // 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
 ConfigSettings configSettings = ConfigSettings.newBuilder().setEndpoint(myEndpoint).build();
 ConfigClient configClient = ConfigClient.create(configSettings);
 

To use REST (HTTP1.1/JSON) transport (instead of gRPC) for sending and receiving requests over the wire:


 // 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
 ConfigSettings configSettings = ConfigSettings.newHttpJsonBuilder().build();
 ConfigClient configClient = ConfigClient.create(configSettings);
 

Please refer to the GitHub repository's samples for more quickstart code snippets.

ConfigClient.ListDeploymentsFixedSizeCollection

ConfigClient.ListDeploymentsPage

ConfigClient.ListDeploymentsPagedResponse

ConfigClient.ListLocationsFixedSizeCollection

ConfigClient.ListLocationsPage

ConfigClient.ListLocationsPagedResponse

ConfigClient.ListResourcesFixedSizeCollection

ConfigClient.ListResourcesPage

ConfigClient.ListResourcesPagedResponse

ConfigClient.ListRevisionsFixedSizeCollection

ConfigClient.ListRevisionsPage

ConfigClient.ListRevisionsPagedResponse

ConfigGrpc

Infrastructure Manager is a managed service that automates the deployment and management of Google Cloud infrastructure resources.

ConfigGrpc.ConfigBlockingStub

A stub to allow clients to do synchronous rpc calls to service Config.

Infrastructure Manager is a managed service that automates the deployment and management of Google Cloud infrastructure resources.

ConfigGrpc.ConfigFutureStub

A stub to allow clients to do ListenableFuture-style rpc calls to service Config.

Infrastructure Manager is a managed service that automates the deployment and management of Google Cloud infrastructure resources.

ConfigGrpc.ConfigImplBase

Base class for the server implementation of the service Config.

Infrastructure Manager is a managed service that automates the deployment and management of Google Cloud infrastructure resources.

ConfigGrpc.ConfigStub

A stub to allow clients to do asynchronous rpc calls to service Config.

Infrastructure Manager is a managed service that automates the deployment and management of Google Cloud infrastructure resources.

ConfigProto

ConfigSettings

Settings class to configure an instance of ConfigClient.

The default instance has everything set to sensible defaults:

  • The default service address (config.googleapis.com) and default port (443) are used.
  • Credentials are acquired automatically through Application Default Credentials.
  • Retries are configured for idempotent methods but not for non-idempotent methods.

The builder of this class is recursive, so contained classes are themselves builders. When build() is called, the tree of builders is called to create the complete settings object.

For example, to set the total timeout of getDeployment to 30 seconds:


 // 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
 ConfigSettings.Builder configSettingsBuilder = ConfigSettings.newBuilder();
 configSettingsBuilder
     .getDeploymentSettings()
     .setRetrySettings(
         configSettingsBuilder
             .getDeploymentSettings()
             .getRetrySettings()
             .toBuilder()
             .setTotalTimeout(Duration.ofSeconds(30))
             .build());
 ConfigSettings configSettings = configSettingsBuilder.build();
 

ConfigSettings.Builder

Builder for ConfigSettings.

CreateDeploymentRequest

Protobuf type google.cloud.config.v1.CreateDeploymentRequest

CreateDeploymentRequest.Builder

Protobuf type google.cloud.config.v1.CreateDeploymentRequest

DeleteDeploymentRequest

Protobuf type google.cloud.config.v1.DeleteDeploymentRequest

DeleteDeploymentRequest.Builder

Protobuf type google.cloud.config.v1.DeleteDeploymentRequest

DeleteStatefileRequest

A request to delete a state file passed to a 'DeleteStatefile' call.

Protobuf type google.cloud.config.v1.DeleteStatefileRequest

DeleteStatefileRequest.Builder

A request to delete a state file passed to a 'DeleteStatefile' call.

Protobuf type google.cloud.config.v1.DeleteStatefileRequest

Deployment

A Deployment is a group of resources and configs managed and provisioned by Infra Manager.

Protobuf type google.cloud.config.v1.Deployment

Deployment.Builder

A Deployment is a group of resources and configs managed and provisioned by Infra Manager.

Protobuf type google.cloud.config.v1.Deployment

DeploymentName

DeploymentName.Builder

Builder for projects/{project}/locations/{location}/deployments/{deployment}.

DeploymentOperationMetadata

Ephemeral metadata content describing the state of a deployment operation.

Protobuf type google.cloud.config.v1.DeploymentOperationMetadata

DeploymentOperationMetadata.Builder

Ephemeral metadata content describing the state of a deployment operation.

Protobuf type google.cloud.config.v1.DeploymentOperationMetadata

ExportDeploymentStatefileRequest

A request to export a state file passed to a 'ExportDeploymentStatefile' call.

Protobuf type google.cloud.config.v1.ExportDeploymentStatefileRequest

ExportDeploymentStatefileRequest.Builder

A request to export a state file passed to a 'ExportDeploymentStatefile' call.

Protobuf type google.cloud.config.v1.ExportDeploymentStatefileRequest

ExportLockInfoRequest

A request to get a state file lock info passed to a 'ExportLockInfo' call.

Protobuf type google.cloud.config.v1.ExportLockInfoRequest

ExportLockInfoRequest.Builder

A request to get a state file lock info passed to a 'ExportLockInfo' call.

Protobuf type google.cloud.config.v1.ExportLockInfoRequest

ExportRevisionStatefileRequest

A request to export a state file passed to a 'ExportRevisionStatefile' call.

Protobuf type google.cloud.config.v1.ExportRevisionStatefileRequest

ExportRevisionStatefileRequest.Builder

A request to export a state file passed to a 'ExportRevisionStatefile' call.

Protobuf type google.cloud.config.v1.ExportRevisionStatefileRequest

GetDeploymentRequest

Protobuf type google.cloud.config.v1.GetDeploymentRequest

GetDeploymentRequest.Builder

Protobuf type google.cloud.config.v1.GetDeploymentRequest

GetResourceRequest

A request to get a Resource from a 'GetResource' call.

Protobuf type google.cloud.config.v1.GetResourceRequest

GetResourceRequest.Builder

A request to get a Resource from a 'GetResource' call.

Protobuf type google.cloud.config.v1.GetResourceRequest

GetRevisionRequest

A request to get a Revision from a 'GetRevision' call.

Protobuf type google.cloud.config.v1.GetRevisionRequest

GetRevisionRequest.Builder

A request to get a Revision from a 'GetRevision' call.

Protobuf type google.cloud.config.v1.GetRevisionRequest

GitSource

A set of files in a Git repository.

Protobuf type google.cloud.config.v1.GitSource

GitSource.Builder

A set of files in a Git repository.

Protobuf type google.cloud.config.v1.GitSource

ImportStatefileRequest

A request to import a state file passed to a 'ImportStatefile' call.

Protobuf type google.cloud.config.v1.ImportStatefileRequest

ImportStatefileRequest.Builder

A request to import a state file passed to a 'ImportStatefile' call.

Protobuf type google.cloud.config.v1.ImportStatefileRequest

ListDeploymentsRequest

Protobuf type google.cloud.config.v1.ListDeploymentsRequest

ListDeploymentsRequest.Builder

Protobuf type google.cloud.config.v1.ListDeploymentsRequest

ListDeploymentsResponse

Protobuf type google.cloud.config.v1.ListDeploymentsResponse

ListDeploymentsResponse.Builder

Protobuf type google.cloud.config.v1.ListDeploymentsResponse

ListResourcesRequest

A request to list Resources passed to a 'ListResources' call.

Protobuf type google.cloud.config.v1.ListResourcesRequest

ListResourcesRequest.Builder

A request to list Resources passed to a 'ListResources' call.

Protobuf type google.cloud.config.v1.ListResourcesRequest

ListResourcesResponse

A response to a 'ListResources' call. Contains a list of Resources.

Protobuf type google.cloud.config.v1.ListResourcesResponse

ListResourcesResponse.Builder

A response to a 'ListResources' call. Contains a list of Resources.

Protobuf type google.cloud.config.v1.ListResourcesResponse

ListRevisionsRequest

A request to list Revisions passed to a 'ListRevisions' call.

Protobuf type google.cloud.config.v1.ListRevisionsRequest

ListRevisionsRequest.Builder

A request to list Revisions passed to a 'ListRevisions' call.

Protobuf type google.cloud.config.v1.ListRevisionsRequest

ListRevisionsResponse

A response to a 'ListRevisions' call. Contains a list of Revisions.

Protobuf type google.cloud.config.v1.ListRevisionsResponse

ListRevisionsResponse.Builder

A response to a 'ListRevisions' call. Contains a list of Revisions.

Protobuf type google.cloud.config.v1.ListRevisionsResponse

LocationName

LocationName.Builder

Builder for projects/{project}/locations/{location}.

LockDeploymentRequest

A request to lock a deployment passed to a 'LockDeployment' call.

Protobuf type google.cloud.config.v1.LockDeploymentRequest

LockDeploymentRequest.Builder

A request to lock a deployment passed to a 'LockDeployment' call.

Protobuf type google.cloud.config.v1.LockDeploymentRequest

LockInfo

Details about the lock which locked the deployment.

Protobuf type google.cloud.config.v1.LockInfo

LockInfo.Builder

Details about the lock which locked the deployment.

Protobuf type google.cloud.config.v1.LockInfo

OperationMetadata

Represents the metadata of the long-running operation.

Protobuf type google.cloud.config.v1.OperationMetadata

OperationMetadata.Builder

Represents the metadata of the long-running operation.

Protobuf type google.cloud.config.v1.OperationMetadata

Resource

Resource represents a Google Cloud Platform resource actuated by IM. Resources are child resources of Revisions.

Protobuf type google.cloud.config.v1.Resource

Resource.Builder

Resource represents a Google Cloud Platform resource actuated by IM. Resources are child resources of Revisions.

Protobuf type google.cloud.config.v1.Resource

ResourceCAIInfo

CAI info of a Resource.

Protobuf type google.cloud.config.v1.ResourceCAIInfo

ResourceCAIInfo.Builder

CAI info of a Resource.

Protobuf type google.cloud.config.v1.ResourceCAIInfo

ResourceName

ResourceName.Builder

Builder for projects/{project}/locations/{location}/deployments/{deployment}/revisions/{revision}/resources/{resource}.

ResourceTerraformInfo

Terraform info of a Resource.

Protobuf type google.cloud.config.v1.ResourceTerraformInfo

ResourceTerraformInfo.Builder

Terraform info of a Resource.

Protobuf type google.cloud.config.v1.ResourceTerraformInfo

Revision

A child resource of a Deployment generated by a 'CreateDeployment' or 'UpdateDeployment' call. Each Revision contains metadata pertaining to a snapshot of a particular Deployment.

Protobuf type google.cloud.config.v1.Revision

Revision.Builder

A child resource of a Deployment generated by a 'CreateDeployment' or 'UpdateDeployment' call. Each Revision contains metadata pertaining to a snapshot of a particular Deployment.

Protobuf type google.cloud.config.v1.Revision

RevisionName

RevisionName.Builder

Builder for projects/{project}/locations/{location}/deployments/{deployment}/revisions/{revision}.

Statefile

Contains info about a Terraform state file

Protobuf type google.cloud.config.v1.Statefile

Statefile.Builder

Contains info about a Terraform state file

Protobuf type google.cloud.config.v1.Statefile

TerraformBlueprint

TerraformBlueprint describes the source of a Terraform root module which describes the resources and configs to be deployed.

Protobuf type google.cloud.config.v1.TerraformBlueprint

TerraformBlueprint.Builder

TerraformBlueprint describes the source of a Terraform root module which describes the resources and configs to be deployed.

Protobuf type google.cloud.config.v1.TerraformBlueprint

TerraformError

Errors encountered during actuation using Terraform

Protobuf type google.cloud.config.v1.TerraformError

TerraformError.Builder

Errors encountered during actuation using Terraform

Protobuf type google.cloud.config.v1.TerraformError

TerraformOutput

Describes a Terraform output.

Protobuf type google.cloud.config.v1.TerraformOutput

TerraformOutput.Builder

Describes a Terraform output.

Protobuf type google.cloud.config.v1.TerraformOutput

TerraformVariable

A Terraform input variable.

Protobuf type google.cloud.config.v1.TerraformVariable

TerraformVariable.Builder

A Terraform input variable.

Protobuf type google.cloud.config.v1.TerraformVariable

UnlockDeploymentRequest

A request to unlock a state file passed to a 'UnlockDeployment' call.

Protobuf type google.cloud.config.v1.UnlockDeploymentRequest

UnlockDeploymentRequest.Builder

A request to unlock a state file passed to a 'UnlockDeployment' call.

Protobuf type google.cloud.config.v1.UnlockDeploymentRequest

UpdateDeploymentRequest

Protobuf type google.cloud.config.v1.UpdateDeploymentRequest

UpdateDeploymentRequest.Builder

Protobuf type google.cloud.config.v1.UpdateDeploymentRequest

Interfaces

ApplyResultsOrBuilder

ConfigGrpc.AsyncService

Infrastructure Manager is a managed service that automates the deployment and management of Google Cloud infrastructure resources.

CreateDeploymentRequestOrBuilder

DeleteDeploymentRequestOrBuilder

DeleteStatefileRequestOrBuilder

DeploymentOperationMetadataOrBuilder

DeploymentOrBuilder

ExportDeploymentStatefileRequestOrBuilder

ExportLockInfoRequestOrBuilder

ExportRevisionStatefileRequestOrBuilder

GetDeploymentRequestOrBuilder

GetResourceRequestOrBuilder

GetRevisionRequestOrBuilder

GitSourceOrBuilder

ImportStatefileRequestOrBuilder

ListDeploymentsRequestOrBuilder

ListDeploymentsResponseOrBuilder

ListResourcesRequestOrBuilder

ListResourcesResponseOrBuilder

ListRevisionsRequestOrBuilder

ListRevisionsResponseOrBuilder

LockDeploymentRequestOrBuilder

LockInfoOrBuilder

OperationMetadataOrBuilder

ResourceCAIInfoOrBuilder

ResourceOrBuilder

ResourceTerraformInfoOrBuilder

RevisionOrBuilder

StatefileOrBuilder

TerraformBlueprintOrBuilder

TerraformErrorOrBuilder

TerraformOutputOrBuilder

TerraformVariableOrBuilder

UnlockDeploymentRequestOrBuilder

UpdateDeploymentRequestOrBuilder

Enums

DeleteDeploymentRequest.DeletePolicy

Policy on how resources actuated by the deployment should be deleted.

Protobuf enum google.cloud.config.v1.DeleteDeploymentRequest.DeletePolicy

Deployment.BlueprintCase

Deployment.ErrorCode

Possible errors that can occur with deployments.

Protobuf enum google.cloud.config.v1.Deployment.ErrorCode

Deployment.LockState

Possible lock states of a deployment.

Protobuf enum google.cloud.config.v1.Deployment.LockState

Deployment.State

Possible states of a deployment.

Protobuf enum google.cloud.config.v1.Deployment.State

DeploymentOperationMetadata.DeploymentStep

The possible steps a deployment may be running.

Protobuf enum google.cloud.config.v1.DeploymentOperationMetadata.DeploymentStep

OperationMetadata.ResourceMetadataCase

Resource.Intent

Possible intent of the resource.

Protobuf enum google.cloud.config.v1.Resource.Intent

Resource.State

Possible states of a resource.

Protobuf enum google.cloud.config.v1.Resource.State

Revision.Action

Actions that generate a revision.

Protobuf enum google.cloud.config.v1.Revision.Action

Revision.BlueprintCase

Revision.ErrorCode

Possible errors if Revision could not be created or updated successfully.

Protobuf enum google.cloud.config.v1.Revision.ErrorCode

Revision.State

Possible states of a revision.

Protobuf enum google.cloud.config.v1.Revision.State

TerraformBlueprint.SourceCase