com.google.cloud.storage

Class Storage.SignUrlOption

java.lang.Object

com.google.cloud.storage.Storage.SignUrlOption

All Implemented Interfaces:

Serializable

Enclosing interface:

Storage

public static class Storage.SignUrlOption
extends Object
implements Serializable

Class for specifying signed URL options.

See Also:

Serialized Form

Method Summary

Modifier and Type	Method and Description
static Storage.SignUrlOption	httpMethod(HttpMethod httpMethod) The HTTP method to be used with the signed URL.
static Storage.SignUrlOption	signWith(com.google.auth.ServiceAccountSigner signer) Provides a service account signer to sign the URL.
static Storage.SignUrlOption	withContentType() Use it if signature should include the blob's content-type.
static Storage.SignUrlOption	withExtHeaders(Map<String,String> extHeaders) Use it if signature should include the blob's canonicalized extended headers.
static Storage.SignUrlOption	withHostName(String hostName) Use a different host name than the default host name 'https://storage.googleapis.com'.
static Storage.SignUrlOption	withMd5() Use it if signature should include the blob's md5.
static Storage.SignUrlOption	withPathStyle() Generate a path-style URL, which places the bucket name in the path portion of the URL instead of in the hostname, e.g 'https://storage.googleapis.com/mybucket/...'.
static Storage.SignUrlOption	withV2Signature() Use if signature version should be V2.
static Storage.SignUrlOption	withV4Signature() Use if signature version should be V4.
static Storage.SignUrlOption	withVirtualHostedStyle() Use a virtual hosted-style hostname, which adds the bucket into the host portion of the URI rather than the path, e.g.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

httpMethod

public static Storage.SignUrlOption httpMethod(HttpMethod httpMethod)

The HTTP method to be used with the signed URL. If this method is not called, defaults to GET.

withContentType

public static Storage.SignUrlOption withContentType()

Use it if signature should include the blob's content-type. When used, users of the signed URL should include the blob's content-type with their request. If using this URL from a browser, you must include a content type that matches what the browser will send.

withMd5

public static Storage.SignUrlOption withMd5()

Use it if signature should include the blob's md5. When used, users of the signed URL should include the blob's md5 with their request.

withExtHeaders

public static Storage.SignUrlOption withExtHeaders(Map<String,String> extHeaders)

Use it if signature should include the blob's canonicalized extended headers. When used, users of the signed URL should include the canonicalized extended headers with their request.

See Also:

Request Headers

withV2Signature

public static Storage.SignUrlOption withV2Signature()

Use if signature version should be V2. This is the default if neither this or withV4Signature() is called.

withV4Signature

public static Storage.SignUrlOption withV4Signature()

Use if signature version should be V4. Note that V4 Signed URLs can't have an expiration longer than 7 days. V2 will be the default if neither this or withV2Signature() is called.

signWith

public static Storage.SignUrlOption signWith(com.google.auth.ServiceAccountSigner signer)

Provides a service account signer to sign the URL. If not provided an attempt will be made to get it from the environment.

See Also:

Service Accounts

withHostName

public static Storage.SignUrlOption withHostName(String hostName)

Use a different host name than the default host name 'https://storage.googleapis.com'. This must also include the scheme component of the URI. This option is particularly useful for developers to point requests to an alternate endpoint (e.g. a staging environment or sending requests through VPC). Note that if using this with the withVirtualHostedStyle() method, you should omit the bucket name from the hostname, as it automatically gets prepended to the hostname for virtual hosted-style URLs.

withVirtualHostedStyle

public static Storage.SignUrlOption withVirtualHostedStyle()

Use a virtual hosted-style hostname, which adds the bucket into the host portion of the URI rather than the path, e.g. 'https://mybucket.storage.googleapis.com/...'. The bucket name will be obtained from the resource passed in. For V4 signing, this also sets the "host" header in the canonicalized extension headers to the virtual hosted-style host, unless that header is supplied via the withExtHeaders() method.

See Also:

Request Endpoints

withPathStyle

public static Storage.SignUrlOption withPathStyle()

Generate a path-style URL, which places the bucket name in the path portion of the URL instead of in the hostname, e.g 'https://storage.googleapis.com/mybucket/...'. Note that this cannot be used alongside withVirtualHostedStyle(). Virtual hosted-style URLs, which can be used via the withVirtualHostedStyle() method, should generally be preferred instead of path-style URLs.

See Also:

Request Endpoints