Package com.google.cloud.orchestration.airflow.service.v1 (1.4.0)

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

EnvironmentsClient

Service Description: Managed Apache Airflow Environments.

Sample for EnvironmentsClient:


 // 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 (EnvironmentsClient environmentsClient = EnvironmentsClient.create()) {
   String name = "name3373707";
   Environment response = environmentsClient.getEnvironment(name);
 }
 

ImageVersionsClient

Service Description: Readonly service to query available ImageVersions.

Sample for ImageVersionsClient:


 // 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 (ImageVersionsClient imageVersionsClient = ImageVersionsClient.create()) {
   String parent = "parent-995424086";
   for (ImageVersion element : imageVersionsClient.listImageVersions(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Classes

CheckUpgradeResponse

Message containing information about the result of an upgrade check operation.

Protobuf type google.cloud.orchestration.airflow.service.v1.CheckUpgradeResponse

CheckUpgradeResponse.Builder

Message containing information about the result of an upgrade check operation.

Protobuf type google.cloud.orchestration.airflow.service.v1.CheckUpgradeResponse

CreateEnvironmentRequest

Create a new environment.

Protobuf type google.cloud.orchestration.airflow.service.v1.CreateEnvironmentRequest

CreateEnvironmentRequest.Builder

Create a new environment.

Protobuf type google.cloud.orchestration.airflow.service.v1.CreateEnvironmentRequest

DatabaseConfig

The configuration of Cloud SQL instance that is used by the Apache Airflow software.

Protobuf type google.cloud.orchestration.airflow.service.v1.DatabaseConfig

DatabaseConfig.Builder

The configuration of Cloud SQL instance that is used by the Apache Airflow software.

Protobuf type google.cloud.orchestration.airflow.service.v1.DatabaseConfig

DeleteEnvironmentRequest

Delete an environment.

Protobuf type google.cloud.orchestration.airflow.service.v1.DeleteEnvironmentRequest

DeleteEnvironmentRequest.Builder

Delete an environment.

Protobuf type google.cloud.orchestration.airflow.service.v1.DeleteEnvironmentRequest

EncryptionConfig

The encryption options for the Cloud Composer environment and its dependencies.

Protobuf type google.cloud.orchestration.airflow.service.v1.EncryptionConfig

EncryptionConfig.Builder

The encryption options for the Cloud Composer environment and its dependencies.

Protobuf type google.cloud.orchestration.airflow.service.v1.EncryptionConfig

Environment

An environment for running orchestration tasks.

Protobuf type google.cloud.orchestration.airflow.service.v1.Environment

Environment.Builder

An environment for running orchestration tasks.

Protobuf type google.cloud.orchestration.airflow.service.v1.Environment

EnvironmentConfig

Configuration information for an environment.

Protobuf type google.cloud.orchestration.airflow.service.v1.EnvironmentConfig

EnvironmentConfig.Builder

Configuration information for an environment.

Protobuf type google.cloud.orchestration.airflow.service.v1.EnvironmentConfig

EnvironmentsClient

Service Description: Managed Apache Airflow Environments.

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 (EnvironmentsClient environmentsClient = EnvironmentsClient.create()) {
   String name = "name3373707";
   Environment response = environmentsClient.getEnvironment(name);
 }
 

Note: close() needs to be called on the EnvironmentsClient 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 EnvironmentsSettings 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
 EnvironmentsSettings environmentsSettings =
     EnvironmentsSettings.newBuilder()
         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
         .build();
 EnvironmentsClient environmentsClient = EnvironmentsClient.create(environmentsSettings);
 

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
 EnvironmentsSettings environmentsSettings =
     EnvironmentsSettings.newBuilder().setEndpoint(myEndpoint).build();
 EnvironmentsClient environmentsClient = EnvironmentsClient.create(environmentsSettings);
 

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
 EnvironmentsSettings environmentsSettings =
     EnvironmentsSettings.newBuilder()
         .setTransportChannelProvider(
             EnvironmentsSettings.defaultHttpJsonTransportProviderBuilder().build())
         .build();
 EnvironmentsClient environmentsClient = EnvironmentsClient.create(environmentsSettings);
 

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

EnvironmentsClient.ListEnvironmentsFixedSizeCollection

EnvironmentsClient.ListEnvironmentsPage

EnvironmentsClient.ListEnvironmentsPagedResponse

EnvironmentsGrpc

Managed Apache Airflow Environments.

EnvironmentsGrpc.EnvironmentsBlockingStub

Managed Apache Airflow Environments.

EnvironmentsGrpc.EnvironmentsFutureStub

Managed Apache Airflow Environments.

EnvironmentsGrpc.EnvironmentsImplBase

Managed Apache Airflow Environments.

EnvironmentsGrpc.EnvironmentsStub

Managed Apache Airflow Environments.

EnvironmentsOuterClass

EnvironmentsSettings

Settings class to configure an instance of EnvironmentsClient.

The default instance has everything set to sensible defaults:

  • The default service address (composer.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 getEnvironment 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
 EnvironmentsSettings.Builder environmentsSettingsBuilder = EnvironmentsSettings.newBuilder();
 environmentsSettingsBuilder
     .getEnvironmentSettings()
     .setRetrySettings(
         environmentsSettingsBuilder.getEnvironmentSettings().getRetrySettings().toBuilder()
             .setTotalTimeout(Duration.ofSeconds(30))
             .build());
 EnvironmentsSettings environmentsSettings = environmentsSettingsBuilder.build();
 

EnvironmentsSettings.Builder

Builder for EnvironmentsSettings.

GetEnvironmentRequest

Get an environment.

Protobuf type google.cloud.orchestration.airflow.service.v1.GetEnvironmentRequest

GetEnvironmentRequest.Builder

Get an environment.

Protobuf type google.cloud.orchestration.airflow.service.v1.GetEnvironmentRequest

IPAllocationPolicy

Configuration for controlling how IPs are allocated in the GKE cluster running the Apache Airflow software.

Protobuf type google.cloud.orchestration.airflow.service.v1.IPAllocationPolicy

IPAllocationPolicy.Builder

Configuration for controlling how IPs are allocated in the GKE cluster running the Apache Airflow software.

Protobuf type google.cloud.orchestration.airflow.service.v1.IPAllocationPolicy

ImageVersion

ImageVersion information

Protobuf type google.cloud.orchestration.airflow.service.v1.ImageVersion

ImageVersion.Builder

ImageVersion information

Protobuf type google.cloud.orchestration.airflow.service.v1.ImageVersion

ImageVersionsClient

Service Description: Readonly service to query available ImageVersions.

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 (ImageVersionsClient imageVersionsClient = ImageVersionsClient.create()) {
   String parent = "parent-995424086";
   for (ImageVersion element : imageVersionsClient.listImageVersions(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Note: close() needs to be called on the ImageVersionsClient 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 ImageVersionsSettings 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
 ImageVersionsSettings imageVersionsSettings =
     ImageVersionsSettings.newBuilder()
         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
         .build();
 ImageVersionsClient imageVersionsClient = ImageVersionsClient.create(imageVersionsSettings);
 

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
 ImageVersionsSettings imageVersionsSettings =
     ImageVersionsSettings.newBuilder().setEndpoint(myEndpoint).build();
 ImageVersionsClient imageVersionsClient = ImageVersionsClient.create(imageVersionsSettings);
 

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
 ImageVersionsSettings imageVersionsSettings =
     ImageVersionsSettings.newBuilder()
         .setTransportChannelProvider(
             ImageVersionsSettings.defaultHttpJsonTransportProviderBuilder().build())
         .build();
 ImageVersionsClient imageVersionsClient = ImageVersionsClient.create(imageVersionsSettings);
 

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

ImageVersionsClient.ListImageVersionsFixedSizeCollection

ImageVersionsClient.ListImageVersionsPage

ImageVersionsClient.ListImageVersionsPagedResponse

ImageVersionsGrpc

Readonly service to query available ImageVersions.

ImageVersionsGrpc.ImageVersionsBlockingStub

Readonly service to query available ImageVersions.

ImageVersionsGrpc.ImageVersionsFutureStub

Readonly service to query available ImageVersions.

ImageVersionsGrpc.ImageVersionsImplBase

Readonly service to query available ImageVersions.

ImageVersionsGrpc.ImageVersionsStub

Readonly service to query available ImageVersions.

ImageVersionsOuterClass

ImageVersionsSettings

Settings class to configure an instance of ImageVersionsClient.

The default instance has everything set to sensible defaults:

  • The default service address (composer.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 listImageVersions 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
 ImageVersionsSettings.Builder imageVersionsSettingsBuilder = ImageVersionsSettings.newBuilder();
 imageVersionsSettingsBuilder
     .listImageVersionsSettings()
     .setRetrySettings(
         imageVersionsSettingsBuilder.listImageVersionsSettings().getRetrySettings().toBuilder()
             .setTotalTimeout(Duration.ofSeconds(30))
             .build());
 ImageVersionsSettings imageVersionsSettings = imageVersionsSettingsBuilder.build();
 

ImageVersionsSettings.Builder

Builder for ImageVersionsSettings.

ListEnvironmentsRequest

List environments in a project and location.

Protobuf type google.cloud.orchestration.airflow.service.v1.ListEnvironmentsRequest

ListEnvironmentsRequest.Builder

List environments in a project and location.

Protobuf type google.cloud.orchestration.airflow.service.v1.ListEnvironmentsRequest

ListEnvironmentsResponse

The environments in a project and location.

Protobuf type google.cloud.orchestration.airflow.service.v1.ListEnvironmentsResponse

ListEnvironmentsResponse.Builder

The environments in a project and location.

Protobuf type google.cloud.orchestration.airflow.service.v1.ListEnvironmentsResponse

ListImageVersionsRequest

List ImageVersions in a project and location.

Protobuf type google.cloud.orchestration.airflow.service.v1.ListImageVersionsRequest

ListImageVersionsRequest.Builder

List ImageVersions in a project and location.

Protobuf type google.cloud.orchestration.airflow.service.v1.ListImageVersionsRequest

ListImageVersionsResponse

The ImageVersions in a project and location.

Protobuf type google.cloud.orchestration.airflow.service.v1.ListImageVersionsResponse

ListImageVersionsResponse.Builder

The ImageVersions in a project and location.

Protobuf type google.cloud.orchestration.airflow.service.v1.ListImageVersionsResponse

NodeConfig

The configuration information for the Kubernetes Engine nodes running the Apache Airflow software.

Protobuf type google.cloud.orchestration.airflow.service.v1.NodeConfig

NodeConfig.Builder

The configuration information for the Kubernetes Engine nodes running the Apache Airflow software.

Protobuf type google.cloud.orchestration.airflow.service.v1.NodeConfig

OperationMetadata

Metadata describing an operation.

Protobuf type google.cloud.orchestration.airflow.service.v1.OperationMetadata

OperationMetadata.Builder

Metadata describing an operation.

Protobuf type google.cloud.orchestration.airflow.service.v1.OperationMetadata

OperationsProto

PrivateClusterConfig

Configuration options for the private GKE cluster in a Cloud Composer environment.

Protobuf type google.cloud.orchestration.airflow.service.v1.PrivateClusterConfig

PrivateClusterConfig.Builder

Configuration options for the private GKE cluster in a Cloud Composer environment.

Protobuf type google.cloud.orchestration.airflow.service.v1.PrivateClusterConfig

PrivateEnvironmentConfig

The configuration information for configuring a Private IP Cloud Composer environment.

Protobuf type google.cloud.orchestration.airflow.service.v1.PrivateEnvironmentConfig

PrivateEnvironmentConfig.Builder

The configuration information for configuring a Private IP Cloud Composer environment.

Protobuf type google.cloud.orchestration.airflow.service.v1.PrivateEnvironmentConfig

SoftwareConfig

Specifies the selection and configuration of software inside the environment.

Protobuf type google.cloud.orchestration.airflow.service.v1.SoftwareConfig

SoftwareConfig.Builder

Specifies the selection and configuration of software inside the environment.

Protobuf type google.cloud.orchestration.airflow.service.v1.SoftwareConfig

UpdateEnvironmentRequest

Update an environment.

Protobuf type google.cloud.orchestration.airflow.service.v1.UpdateEnvironmentRequest

UpdateEnvironmentRequest.Builder

Update an environment.

Protobuf type google.cloud.orchestration.airflow.service.v1.UpdateEnvironmentRequest

WebServerConfig

The configuration settings for the Airflow web server App Engine instance.

Protobuf type google.cloud.orchestration.airflow.service.v1.WebServerConfig

WebServerConfig.Builder

The configuration settings for the Airflow web server App Engine instance.

Protobuf type google.cloud.orchestration.airflow.service.v1.WebServerConfig

WebServerNetworkAccessControl

Network-level access control policy for the Airflow web server.

Protobuf type google.cloud.orchestration.airflow.service.v1.WebServerNetworkAccessControl

WebServerNetworkAccessControl.AllowedIpRange

Allowed IP range with user-provided description.

Protobuf type google.cloud.orchestration.airflow.service.v1.WebServerNetworkAccessControl.AllowedIpRange

WebServerNetworkAccessControl.AllowedIpRange.Builder

Allowed IP range with user-provided description.

Protobuf type google.cloud.orchestration.airflow.service.v1.WebServerNetworkAccessControl.AllowedIpRange

WebServerNetworkAccessControl.Builder

Network-level access control policy for the Airflow web server.

Protobuf type google.cloud.orchestration.airflow.service.v1.WebServerNetworkAccessControl

Interfaces

CheckUpgradeResponseOrBuilder

CreateEnvironmentRequestOrBuilder

DatabaseConfigOrBuilder

DeleteEnvironmentRequestOrBuilder

EncryptionConfigOrBuilder

EnvironmentConfigOrBuilder

EnvironmentOrBuilder

GetEnvironmentRequestOrBuilder

IPAllocationPolicyOrBuilder

ImageVersionOrBuilder

ListEnvironmentsRequestOrBuilder

ListEnvironmentsResponseOrBuilder

ListImageVersionsRequestOrBuilder

ListImageVersionsResponseOrBuilder

NodeConfigOrBuilder

OperationMetadataOrBuilder

PrivateClusterConfigOrBuilder

PrivateEnvironmentConfigOrBuilder

SoftwareConfigOrBuilder

UpdateEnvironmentRequestOrBuilder

WebServerConfigOrBuilder

WebServerNetworkAccessControl.AllowedIpRangeOrBuilder

WebServerNetworkAccessControlOrBuilder

Enums

CheckUpgradeResponse.ConflictResult

Whether there were python modules conflict during image build.

Protobuf enum google.cloud.orchestration.airflow.service.v1.CheckUpgradeResponse.ConflictResult

Environment.State

State of the environment.

Protobuf enum google.cloud.orchestration.airflow.service.v1.Environment.State

IPAllocationPolicy.ClusterIpAllocationCase

IPAllocationPolicy.ServicesIpAllocationCase

OperationMetadata.State

An enum describing the overall state of an operation.

Protobuf enum google.cloud.orchestration.airflow.service.v1.OperationMetadata.State

OperationMetadata.Type

Type of longrunning operation.

Protobuf enum google.cloud.orchestration.airflow.service.v1.OperationMetadata.Type