Google Cloud Storage Transfer V1 Client - Class AwsS3Data (2.0.0-RC1)

Reference documentation and code samples for the Google Cloud Storage Transfer V1 Client class 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.

Generated from protobuf message google.storagetransfer.v1.AwsS3Data

Namespace

Google \ Cloud \ StorageTransfer \ V1

Methods

__construct

Constructor.

Parameters
Name	Description
`data`	`array` Optional. Data for populating the Message object.
`↳ bucket_name`	`string` Required. S3 Bucket name (see Creating a bucket).
`↳ aws_access_key`	`Google\Cloud\StorageTransfer\V1\AwsAccessKey` Input only. AWS access key used to sign the API requests to the AWS S3 bucket. Permissions on the bucket must be granted to the access ID of the AWS access key. For information on our data retention policy for user credentials, see User credentials.
`↳ path`	`string` Root path to transfer objects. Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'.
`↳ role_arn`	`string` The Amazon Resource Name (ARN) of the role to support temporary credentials via `AssumeRoleWithWebIdentity`. For more information about ARNs, see IAM ARNs. When a role ARN is provided, Transfer Service fetches temporary credentials for the session using a `AssumeRoleWithWebIdentity` call for the provided role using the GoogleServiceAccount for this project.
`↳ credentials_secret`	`string` Optional. The Resource name of a secret in Secret Manager. The Azure SAS token must be stored in Secret Manager in JSON format: { "sas_token" : "`SAS_TOKEN`" } GoogleServiceAccount must be granted `roles/secretmanager.secretAccessor` for the resource. See Configure access to a source: Microsoft Azure Blob Storage for more information. If `credentials_secret` is specified, do not specify azure_credentials. This feature is in preview. Format: `projects/{project_number}/secrets/{secret_name}`

getBucketName

Required. S3 Bucket name (see Creating a bucket).

Returns
Type	Description
`string`

setBucketName

Required. S3 Bucket name (see Creating a bucket).

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getAwsAccessKey

Input only. AWS access key used to sign the API requests to the AWS S3 bucket. Permissions on the bucket must be granted to the access ID of the AWS access key.

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

Returns
Type	Description
`Google\Cloud\StorageTransfer\V1\AwsAccessKey\|null`

hasAwsAccessKey

clearAwsAccessKey

setAwsAccessKey

Input only. AWS access key used to sign the API requests to the AWS S3 bucket. Permissions on the bucket must be granted to the access ID of the AWS access key.

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

Parameter
Name	Description
`var`	`Google\Cloud\StorageTransfer\V1\AwsAccessKey`

Returns
Type	Description
`$this`

getPath

Root path to transfer objects.

Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'.

Returns
Type	Description
`string`

setPath

Root path to transfer objects.

Must be an empty string or full path name that ends with a '/'. This field is treated as an object prefix. As such, it should generally not begin with a '/'.

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getRoleArn

The Amazon Resource Name (ARN) of the role to support temporary credentials via AssumeRoleWithWebIdentity. For more information about ARNs, see IAM ARNs.

When a role ARN is provided, Transfer Service fetches temporary credentials for the session using a AssumeRoleWithWebIdentity call for the provided role using the GoogleServiceAccount for this project.

Returns
Type	Description
`string`

setRoleArn

The Amazon Resource Name (ARN) of the role to support temporary credentials via AssumeRoleWithWebIdentity. For more information about ARNs, see IAM ARNs.

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getCredentialsSecret

Optional. The Resource name of a secret in Secret Manager.

The Azure SAS token must be stored in Secret Manager in JSON format:

{
 "sas_token" : "SAS_TOKEN"
}

GoogleServiceAccount must be granted roles/secretmanager.secretAccessor for the resource. See Configure access to a source: Microsoft Azure Blob Storage for more information. If credentials_secret is specified, do not specify azure_credentials. This feature is in preview. Format: projects/{project_number}/secrets/{secret_name}

Returns
Type	Description
`string`

setCredentialsSecret

Optional. The Resource name of a secret in Secret Manager.

The Azure SAS token must be stored in Secret Manager in JSON format:

{
 "sas_token" : "SAS_TOKEN"
}

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`