Storage Transfer v1 API - Namespace Google.Cloud.StorageTransfer.V1 (2.2.0)

Classes

AgentPool

Represents an On-Premises Agent pool.

AgentPool.Types

Container for nested types declared in the AgentPool message type.

AgentPool.Types.BandwidthLimit

Specifies a bandwidth limit for an agent pool.

agentPoolsName

Resource name for the agentPools resource.

AwsAccessKey

AWS access key (see AWS Security Credentials).

For information on our data retention policy for user credentials, see User credentials.

AwsS3CompatibleData

An AwsS3CompatibleData resource.

AwsS3Data

An AwsS3Data resource can be a data source, but not a data sink. In an AwsS3Data resource, an object's name is the S3 object's key name.

AzureBlobStorageData

An AzureBlobStorageData resource can be a data source, but not a data sink. An AzureBlobStorageData resource represents one Azure container. The storage account determines the Azure endpoint. In an AzureBlobStorageData resource, a blobs's name is the Azure Blob Storage blob's key name.

AzureCredentials

Azure credentials

For information on our data retention policy for user credentials, see User credentials.

CreateAgentPoolRequest

Specifies the request passed to CreateAgentPool.

CreateTransferJobRequest

Request passed to CreateTransferJob.

DeleteAgentPoolRequest

Specifies the request passed to DeleteAgentPool.

DeleteTransferJobRequest

Request passed to DeleteTransferJob.

ErrorLogEntry

An entry describing an error that has occurred.

ErrorSummary

A summary of errors by error code, plus a count and sample error log entries.

GcsData

In a GcsData resource, an object's name is the Cloud Storage object's name and its "last modification time" refers to the object's updated property of Cloud Storage objects, which changes when the content or the metadata of the object is updated.

GetAgentPoolRequest

Specifies the request passed to GetAgentPool.

GetGoogleServiceAccountRequest

Request passed to GetGoogleServiceAccount.

GetTransferJobRequest

Request passed to GetTransferJob.

GoogleServiceAccount

Google service account

HttpData

An HttpData resource specifies a list of objects on the web to be transferred over HTTP. The information of the objects to be transferred is contained in a file referenced by a URL. The first line in the file must be "TsvHttpData-1.0", which specifies the format of the file. Subsequent lines specify the information of the list of objects, one object per list entry. Each entry has the following tab-delimited fields:

  • HTTP URL — The location of the object.

  • Length — The size of the object in bytes.

  • MD5 — The base64-encoded MD5 hash of the object.

For an example of a valid TSV file, see Transferring data from URLs.

When transferring data based on a URL list, keep the following in mind:

  • When an object located at http(s)://hostname:port/<URL-path> is transferred to a data sink, the name of the object at the data sink is <hostname>/<URL-path>.

  • If the specified size of an object does not match the actual size of the object fetched, the object is not transferred.

  • If the specified MD5 does not match the MD5 computed from the transferred bytes, the object transfer fails.

  • Ensure that each URL you specify is publicly accessible. For example, in Cloud Storage you can share an object publicly and get a link to it.

  • Storage Transfer Service obeys robots.txt rules and requires the source HTTP server to support Range requests and to return a Content-Length header in each response.

  • [ObjectConditions][google.storagetransfer.v1.ObjectConditions] have no effect when filtering objects to transfer.

ListAgentPoolsRequest

The request passed to ListAgentPools.

ListAgentPoolsResponse

Response from ListAgentPools.

ListTransferJobsRequest

projectId, jobNames, and jobStatuses are query parameters that can be specified when listing transfer jobs.

ListTransferJobsResponse

Response from ListTransferJobs.

LoggingConfig

Specifies the logging behavior for transfer operations.

For cloud-to-cloud transfers, logs are sent to Cloud Logging. See Read transfer logs for details.

For transfers to or from a POSIX file system, logs are stored in the Cloud Storage bucket that is the source or sink of the transfer. See Managing Transfer for on-premises jobs for details.

LoggingConfig.Types

Container for nested types declared in the LoggingConfig message type.

MetadataOptions

Specifies the metadata options for running a transfer.

MetadataOptions.Types

Container for nested types declared in the MetadataOptions message type.

NotificationConfig

Specification to configure notifications published to Pub/Sub. Notifications are published to the customer-provided topic using the following PubsubMessage.attributes:

  • &quot;eventType&quot;: one of the [EventType][google.storagetransfer.v1.NotificationConfig.EventType] values
  • &quot;payloadFormat&quot;: one of the [PayloadFormat][google.storagetransfer.v1.NotificationConfig.PayloadFormat] values
  • &quot;projectId&quot;: the [project_id][google.storagetransfer.v1.TransferOperation.project_id] of the TransferOperation
  • &quot;transferJobName&quot;: the [transfer_job_name][google.storagetransfer.v1.TransferOperation.transfer_job_name] of the TransferOperation
  • &quot;transferOperationName&quot;: the [name][google.storagetransfer.v1.TransferOperation.name] of the TransferOperation

The PubsubMessage.data contains a [TransferOperation][google.storagetransfer.v1.TransferOperation] resource formatted according to the specified PayloadFormat.

NotificationConfig.Types

Container for nested types declared in the NotificationConfig message type.

ObjectConditions

Conditions that determine which objects are transferred. Applies only to Cloud Data Sources such as S3, Azure, and Cloud Storage.

The "last modification time" refers to the time of the last change to the object's content or metadata — specifically, this is the updated property of Cloud Storage objects, the LastModified field of S3 objects, and the Last-Modified header of Azure blobs.

Transfers with a [PosixFilesystem][google.storagetransfer.v1.PosixFilesystem] source or destination don't support ObjectConditions.

PauseTransferOperationRequest

Request passed to PauseTransferOperation.

PosixFilesystem

A POSIX filesystem resource.

ResumeTransferOperationRequest

Request passed to ResumeTransferOperation.

RunTransferJobRequest

Request passed to RunTransferJob.

S3CompatibleMetadata

S3CompatibleMetadata contains the metadata fields that apply to the basic types of S3-compatible data providers.

S3CompatibleMetadata.Types

Container for nested types declared in the S3CompatibleMetadata message type.

Schedule

Transfers can be scheduled to recur or to run just once.

StorageTransferService

Storage Transfer Service and its protos. Transfers data between between Google Cloud Storage buckets or from a data source external to Google to a Cloud Storage bucket.

StorageTransferService.StorageTransferServiceBase

Base class for server-side implementations of StorageTransferService

StorageTransferService.StorageTransferServiceClient

Client for StorageTransferService

StorageTransferServiceClient

StorageTransferService client wrapper, for convenient use.

StorageTransferServiceClientBuilder

Builder class for StorageTransferServiceClient to provide simple configuration of credentials, endpoint etc.

StorageTransferServiceClientImpl

StorageTransferService client wrapper implementation, for convenient use.

StorageTransferServiceSettings

Settings for StorageTransferServiceClient instances.

TransferCounters

A collection of counters that report the progress of a transfer operation.

TransferJob

This resource represents the configuration of a transfer job that runs periodically.

TransferJob.Types

Container for nested types declared in the TransferJob message type.

TransferManifest

Specifies where the manifest is located.

TransferOperation

A description of the execution of a transfer.

TransferOperation.Types

Container for nested types declared in the TransferOperation message type.

TransferOptions

TransferOptions define the actions to be performed on objects in a transfer.

TransferOptions.Types

Container for nested types declared in the TransferOptions message type.

TransferSpec

Configuration for running a transfer.

UpdateAgentPoolRequest

Specifies the request passed to UpdateAgentPool.

UpdateTransferJobRequest

Request passed to UpdateTransferJob.

Enums

AgentPool.Types.State

The state of an AgentPool.

agentPoolsName.ResourceNameType

The possible contents of agentPoolsName.

AwsS3CompatibleData.DataProviderOneofCase

Enum of possible cases for the "data_provider" oneof.

LoggingConfig.Types.LoggableAction

Loggable actions.

LoggingConfig.Types.LoggableActionState

Loggable action states.

MetadataOptions.Types.Acl

Options for handling Cloud Storage object ACLs.

MetadataOptions.Types.GID

Options for handling file GID attribute.

MetadataOptions.Types.KmsKey

Options for handling the KmsKey setting for Google Cloud Storage objects.

MetadataOptions.Types.Mode

Options for handling file mode attribute.

MetadataOptions.Types.StorageClass

Options for handling Google Cloud Storage object storage class.

Whether symlinks should be skipped or preserved during a transfer job.

MetadataOptions.Types.TemporaryHold

Options for handling temporary holds for Google Cloud Storage objects.

MetadataOptions.Types.TimeCreated

Options for handling timeCreated metadata for Google Cloud Storage objects.

MetadataOptions.Types.UID

Options for handling file UID attribute.

NotificationConfig.Types.EventType

Enum for specifying event types for which notifications are to be published.

Additional event types may be added in the future. Clients should either safely ignore unrecognized event types or explicitly specify which event types they are prepared to accept.

NotificationConfig.Types.PayloadFormat

Enum for specifying the format of a notification message's payload.

S3CompatibleMetadata.Types.AuthMethod

The authentication and authorization method used by the storage service.

S3CompatibleMetadata.Types.ListApi

The Listing API to use for discovering objects.

S3CompatibleMetadata.Types.NetworkProtocol

The agent network protocol to access the storage service.

S3CompatibleMetadata.Types.RequestModel

The request model of the API.

TransferJob.Types.Status

The status of the transfer job.

TransferOperation.Types.Status

The status of a TransferOperation.

TransferOptions.Types.OverwriteWhen

Specifies when to overwrite an object in the sink when an object with matching name is found in the source.

TransferSpec.DataSinkOneofCase

Enum of possible cases for the "data_sink" oneof.

TransferSpec.DataSourceOneofCase

Enum of possible cases for the "data_source" oneof.

TransferSpec.IntermediateDataLocationOneofCase

Enum of possible cases for the "intermediate_data_location" oneof.