The "objects" collection of methods.
Typical usage is:
$storageService = new Google_Service_Storage(...);
$objects = $storageService->objects;
Table of Contents
-
$client
: Google_Client
-
$methods
: array<string|int, mixed>
-
$resourceName
: string
-
$rootUrl
: string
-
$serviceName
: string
-
$servicePath
: string
-
$stackParameters
: mixed
-
__construct()
: mixed
-
call()
: Google_Http_Request|expectedClass
- TODO: This function needs simplifying.
-
compose()
: Google_Service_Storage_StorageObject
- Concatenates a list of existing objects into a new object in the same bucket.
-
copy()
: Google_Service_Storage_StorageObject
- Copies a source object to a destination object. Optionally overrides
metadata. (objects.copy)
-
createRequestUri()
: string
- Parse/expand request parameters and create a fully qualified
request uri.
-
delete()
: mixed
- Deletes an object and its metadata. Deletions are permanent if versioning is
not enabled for the bucket, or if the generation parameter is used.
-
get()
: Google_Service_Storage_StorageObject
- Retrieves an object or its metadata. (objects.get)
-
getIamPolicy()
: Google_Service_Storage_Policy
- Returns an IAM policy for the specified object. (objects.getIamPolicy)
-
insert()
: Google_Service_Storage_StorageObject
- Stores a new object and metadata. (objects.insert)
-
listObjects()
: Google_Service_Storage_Objects
- Retrieves a list of objects matching the criteria. (objects.listObjects)
-
patch()
: Google_Service_Storage_StorageObject
- Patches an object's metadata. (objects.patch)
-
rewrite()
: Google_Service_Storage_RewriteResponse
- Rewrites a source object to a destination object. Optionally overrides
metadata. (objects.rewrite)
-
setIamPolicy()
: Google_Service_Storage_Policy
- Updates an IAM policy for the specified object. (objects.setIamPolicy)
-
testIamPermissions()
: Google_Service_Storage_TestIamPermissionsResponse
- Tests a set of permissions on the given object to see which, if any, are held
by the caller. (objects.testIamPermissions)
-
update()
: Google_Service_Storage_StorageObject
- Updates an object's metadata. (objects.update)
-
watchAll()
: Google_Service_Storage_Channel
- Watch for changes on all objects in a bucket. (objects.watchAll)
-
convertToArrayAndStripNulls()
: mixed
$client
private
Google_Client
$client
$methods
private
array<string|int, mixed>
$methods
$resourceName
private
string
$resourceName
$rootUrl
private
string
$rootUrl
$serviceName
private
string
$serviceName
$servicePath
private
string
$servicePath
$stackParameters
private
mixed
$stackParameters
= array('alt' => array('type' => 'string', 'location' => 'query'), 'fields' => array('type' => 'string', 'location' => 'query'), 'trace' => array('type' => 'string', 'location' => 'query'), 'userIp' => array('type' => 'string', 'location' => 'query'), 'quotaUser' => array('type' => 'string', 'location' => 'query'), 'data' => array('type' => 'string', 'location' => 'body'), 'mimeType' => array('type' => 'string', 'location' => 'header'), 'uploadType' => array('type' => 'string', 'location' => 'query'), 'mediaUpload' => array('type' => 'complex', 'location' => 'query'), 'prettyPrint' => array('type' => 'string', 'location' => 'query'))
__construct()
public
__construct(mixed $service, mixed $serviceName, mixed $resourceName, mixed $resource) : mixed
Parameters
-
$service
: mixed
-
-
$serviceName
: mixed
-
-
$resourceName
: mixed
-
-
$resource
: mixed
-
Return values
mixed
—
call()
TODO: This function needs simplifying.
public
call( $name, $arguments[, $expectedClass = null ]) : Google_Http_Request|expectedClass
Parameters
-
$name
:
-
-
$arguments
:
-
-
$expectedClass
:
= null
-
- optional, the expected class name
-
throws
-
Google_Exception
Return values
Google_Http_Request|expectedClass
—
compose()
Concatenates a list of existing objects into a new object in the same bucket.
public
compose(string $destinationBucket, string $destinationObject, Google_Service_Storage_ComposeRequest $postBody[, array<string|int, mixed> $optParams = array() ]) : Google_Service_Storage_StorageObject
Parameters
-
$destinationBucket
: string
-
Name of the bucket containing the source
objects. The destination object is stored in this bucket.
-
$destinationObject
: string
-
Name of the new object. For information
about how to URL encode object names to be path safe, see Encoding URI Path
Parts.
-
$postBody
: Google_Service_Storage_ComposeRequest
-
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
string destinationPredefinedAcl Apply a predefined set of access
controls to the destination object.
-
opt_param
-
string ifGenerationMatch Makes the operation conditional on
whether the object's current generation matches the given value. Setting to 0
makes the operation succeed only if there are no live versions of the object.
-
opt_param
-
string ifMetagenerationMatch Makes the operation conditional on
whether the object's current metageneration matches the given value.
-
opt_param
-
string kmsKeyName Resource name of the Cloud KMS key, of the form
projects/my-project/locations/global/keyRings/my-kr/cryptoKeys/my-key, that
will be used to encrypt the object. Overrides the object metadata's
kms_key_name value, if any.
-
opt_param
-
string provisionalUserProject The project to be billed for this
request if the target bucket is requester-pays bucket.
-
opt_param
-
string userProject The project to be billed for this request.
Required for Requester Pays buckets.
Return values
Google_Service_Storage_StorageObject
—
copy()
Copies a source object to a destination object. Optionally overrides
metadata. (objects.copy)
public
copy(string $sourceBucket, string $sourceObject, string $destinationBucket, string $destinationObject, Google_Service_Storage_StorageObject $postBody[, array<string|int, mixed> $optParams = array() ]) : Google_Service_Storage_StorageObject
Parameters
-
$sourceBucket
: string
-
Name of the bucket in which to find the source
object.
-
$sourceObject
: string
-
Name of the source object. For information about
how to URL encode object names to be path safe, see Encoding URI Path Parts.
-
$destinationBucket
: string
-
Name of the bucket in which to store the new
object. Overrides the provided object metadata's bucket value, if any.For
information about how to URL encode object names to be path safe, see
Encoding URI Path Parts.
-
$destinationObject
: string
-
Name of the new object. Required when the
object metadata is not otherwise provided. Overrides the object metadata's
name value, if any.
-
$postBody
: Google_Service_Storage_StorageObject
-
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
string destinationKmsKeyName Resource name of the Cloud KMS key,
of the form projects/my-project/locations/global/keyRings/my-kr/cryptoKeys
/my-key, that will be used to encrypt the object. Overrides the object
metadata's kms_key_name value, if any.
-
opt_param
-
string destinationPredefinedAcl Apply a predefined set of access
controls to the destination object.
-
opt_param
-
string ifGenerationMatch Makes the operation conditional on
whether the destination object's current generation matches the given value.
Setting to 0 makes the operation succeed only if there are no live versions
of the object.
-
opt_param
-
string ifGenerationNotMatch Makes the operation conditional on
whether the destination object's current generation does not match the given
value. If no live object exists, the precondition fails. Setting to 0 makes
the operation succeed only if there is a live version of the object.
-
opt_param
-
string ifMetagenerationMatch Makes the operation conditional on
whether the destination object's current metageneration matches the given
value.
-
opt_param
-
string ifMetagenerationNotMatch Makes the operation conditional on
whether the destination object's current metageneration does not match the
given value.
-
opt_param
-
string ifSourceGenerationMatch Makes the operation conditional on
whether the source object's current generation matches the given value.
-
opt_param
-
string ifSourceGenerationNotMatch Makes the operation conditional
on whether the source object's current generation does not match the given
value.
-
opt_param
-
string ifSourceMetagenerationMatch Makes the operation conditional
on whether the source object's current metageneration matches the given
value.
-
opt_param
-
string ifSourceMetagenerationNotMatch Makes the operation
conditional on whether the source object's current metageneration does not
match the given value.
-
opt_param
-
string projection Set of properties to return. Defaults to noAcl,
unless the object resource specifies the acl property, when it defaults to
full.
-
opt_param
-
string provisionalUserProject The project to be billed for this
request if the target bucket is requester-pays bucket.
-
opt_param
-
string sourceGeneration If present, selects a specific revision of
the source object (as opposed to the latest version, the default).
-
opt_param
-
string userProject The project to be billed for this request.
Required for Requester Pays buckets.
Return values
Google_Service_Storage_StorageObject
—
createRequestUri()
Parse/expand request parameters and create a fully qualified
request uri.
public
createRequestUri(string $restPath, array<string|int, mixed> $params) : string
Parameters
-
$restPath
: string
-
-
$params
: array<string|int, mixed>
-
-
static
-
Return values
string
—
delete()
Deletes an object and its metadata. Deletions are permanent if versioning is
not enabled for the bucket, or if the generation parameter is used.
public
delete(string $bucket, string $object[, array<string|int, mixed> $optParams = array() ]) : mixed
Parameters
-
$bucket
: string
-
Name of the bucket in which the object resides.
-
$object
: string
-
Name of the object. For information about how to URL
encode object names to be path safe, see Encoding URI Path Parts.
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
string generation If present, permanently deletes a specific
revision of this object (as opposed to the latest version, the default).
-
opt_param
-
string ifGenerationMatch Makes the operation conditional on
whether the object's current generation matches the given value. Setting to 0
makes the operation succeed only if there are no live versions of the object.
-
opt_param
-
string ifGenerationNotMatch Makes the operation conditional on
whether the object's current generation does not match the given value. If no
live object exists, the precondition fails. Setting to 0 makes the operation
succeed only if there is a live version of the object.
-
opt_param
-
string ifMetagenerationMatch Makes the operation conditional on
whether the object's current metageneration matches the given value.
-
opt_param
-
string ifMetagenerationNotMatch Makes the operation conditional on
whether the object's current metageneration does not match the given value.
-
opt_param
-
string provisionalUserProject The project to be billed for this
request if the target bucket is requester-pays bucket.
-
opt_param
-
string userProject The project to be billed for this request.
Required for Requester Pays buckets.
Return values
mixed
—
get()
Retrieves an object or its metadata. (objects.get)
public
get(string $bucket, string $object[, array<string|int, mixed> $optParams = array() ]) : Google_Service_Storage_StorageObject
Parameters
-
$bucket
: string
-
Name of the bucket in which the object resides.
-
$object
: string
-
Name of the object. For information about how to URL
encode object names to be path safe, see Encoding URI Path Parts.
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
string generation If present, selects a specific revision of this
object (as opposed to the latest version, the default).
-
opt_param
-
string ifGenerationMatch Makes the operation conditional on
whether the object's current generation matches the given value. Setting to 0
makes the operation succeed only if there are no live versions of the object.
-
opt_param
-
string ifGenerationNotMatch Makes the operation conditional on
whether the object's current generation does not match the given value. If no
live object exists, the precondition fails. Setting to 0 makes the operation
succeed only if there is a live version of the object.
-
opt_param
-
string ifMetagenerationMatch Makes the operation conditional on
whether the object's current metageneration matches the given value.
-
opt_param
-
string ifMetagenerationNotMatch Makes the operation conditional on
whether the object's current metageneration does not match the given value.
-
opt_param
-
string projection Set of properties to return. Defaults to noAcl.
-
opt_param
-
string provisionalUserProject The project to be billed for this
request if the target bucket is requester-pays bucket.
-
opt_param
-
string userProject The project to be billed for this request.
Required for Requester Pays buckets.
Return values
Google_Service_Storage_StorageObject
—
getIamPolicy()
Returns an IAM policy for the specified object. (objects.getIamPolicy)
public
getIamPolicy(string $bucket, string $object[, array<string|int, mixed> $optParams = array() ]) : Google_Service_Storage_Policy
Parameters
-
$bucket
: string
-
Name of the bucket in which the object resides.
-
$object
: string
-
Name of the object. For information about how to URL
encode object names to be path safe, see Encoding URI Path Parts.
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
string generation If present, selects a specific revision of this
object (as opposed to the latest version, the default).
-
opt_param
-
string provisionalUserProject The project to be billed for this
request if the target bucket is requester-pays bucket.
-
opt_param
-
string userProject The project to be billed for this request.
Required for Requester Pays buckets.
Return values
Google_Service_Storage_Policy
—
insert()
Stores a new object and metadata. (objects.insert)
public
insert(string $bucket, Google_Service_Storage_StorageObject $postBody[, array<string|int, mixed> $optParams = array() ]) : Google_Service_Storage_StorageObject
Parameters
-
$bucket
: string
-
Name of the bucket in which to store the new object.
Overrides the provided object metadata's bucket value, if any.
-
$postBody
: Google_Service_Storage_StorageObject
-
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
string contentEncoding If set, sets the contentEncoding property
of the final object to this value. Setting this parameter is equivalent to
setting the contentEncoding metadata property. This can be useful when
uploading an object with uploadType=media to indicate the encoding of the
content being uploaded.
-
opt_param
-
string ifGenerationMatch Makes the operation conditional on
whether the object's current generation matches the given value. Setting to 0
makes the operation succeed only if there are no live versions of the object.
-
opt_param
-
string ifGenerationNotMatch Makes the operation conditional on
whether the object's current generation does not match the given value. If no
live object exists, the precondition fails. Setting to 0 makes the operation
succeed only if there is a live version of the object.
-
opt_param
-
string ifMetagenerationMatch Makes the operation conditional on
whether the object's current metageneration matches the given value.
-
opt_param
-
string ifMetagenerationNotMatch Makes the operation conditional on
whether the object's current metageneration does not match the given value.
-
opt_param
-
string kmsKeyName Resource name of the Cloud KMS key, of the form
projects/my-project/locations/global/keyRings/my-kr/cryptoKeys/my-key, that
will be used to encrypt the object. Overrides the object metadata's
kms_key_name value, if any.
-
opt_param
-
string name Name of the object. Required when the object metadata
is not otherwise provided. Overrides the object metadata's name value, if
any. For information about how to URL encode object names to be path safe,
see Encoding URI Path Parts.
-
opt_param
-
string predefinedAcl Apply a predefined set of access controls to
this object.
-
opt_param
-
string projection Set of properties to return. Defaults to noAcl,
unless the object resource specifies the acl property, when it defaults to
full.
-
opt_param
-
string provisionalUserProject The project to be billed for this
request if the target bucket is requester-pays bucket.
-
opt_param
-
string userProject The project to be billed for this request.
Required for Requester Pays buckets.
Return values
Google_Service_Storage_StorageObject
—
listObjects()
Retrieves a list of objects matching the criteria. (objects.listObjects)
public
listObjects(string $bucket[, array<string|int, mixed> $optParams = array() ]) : Google_Service_Storage_Objects
Parameters
-
$bucket
: string
-
Name of the bucket in which to look for objects.
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
string delimiter Returns results in a directory-like mode. items
will contain only objects whose names, aside from the prefix, do not contain
delimiter. Objects whose names, aside from the prefix, contain delimiter will
have their name, truncated after the delimiter, returned in prefixes.
Duplicate prefixes are omitted.
-
opt_param
-
string endOffset Filter results to objects whose names are
lexicographically before endOffset. If startOffset is also set, the objects
listed will have names between startOffset (inclusive) and endOffset
(exclusive).
-
opt_param
-
bool includeTrailingDelimiter If true, objects that end in exactly
one instance of delimiter will have their metadata included in items in
addition to prefixes.
-
opt_param
-
string maxResults Maximum number of items plus prefixes to return
in a single page of responses. As duplicate prefixes are omitted, fewer total
results may be returned than requested. The service will use this parameter
or 1,000 items, whichever is smaller.
-
opt_param
-
string pageToken A previously-returned page token representing
part of the larger set of results to view.
-
opt_param
-
string prefix Filter results to objects whose names begin with
this prefix.
-
opt_param
-
string projection Set of properties to return. Defaults to noAcl.
-
opt_param
-
string provisionalUserProject The project to be billed for this
request if the target bucket is requester-pays bucket.
-
opt_param
-
string startOffset Filter results to objects whose names are
lexicographically equal to or after startOffset. If endOffset is also set,
the objects listed will have names between startOffset (inclusive) and
endOffset (exclusive).
-
opt_param
-
string userProject The project to be billed for this request.
Required for Requester Pays buckets.
-
opt_param
-
bool versions If true, lists all versions of an object as distinct
results. The default is false. For more information, see Object Versioning.
Return values
Google_Service_Storage_Objects
—
patch()
Patches an object's metadata. (objects.patch)
public
patch(string $bucket, string $object, Google_Service_Storage_StorageObject $postBody[, array<string|int, mixed> $optParams = array() ]) : Google_Service_Storage_StorageObject
Parameters
-
$bucket
: string
-
Name of the bucket in which the object resides.
-
$object
: string
-
Name of the object. For information about how to URL
encode object names to be path safe, see Encoding URI Path Parts.
-
$postBody
: Google_Service_Storage_StorageObject
-
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
string generation If present, selects a specific revision of this
object (as opposed to the latest version, the default).
-
opt_param
-
string ifGenerationMatch Makes the operation conditional on
whether the object's current generation matches the given value. Setting to 0
makes the operation succeed only if there are no live versions of the object.
-
opt_param
-
string ifGenerationNotMatch Makes the operation conditional on
whether the object's current generation does not match the given value. If no
live object exists, the precondition fails. Setting to 0 makes the operation
succeed only if there is a live version of the object.
-
opt_param
-
string ifMetagenerationMatch Makes the operation conditional on
whether the object's current metageneration matches the given value.
-
opt_param
-
string ifMetagenerationNotMatch Makes the operation conditional on
whether the object's current metageneration does not match the given value.
-
opt_param
-
string predefinedAcl Apply a predefined set of access controls to
this object.
-
opt_param
-
string projection Set of properties to return. Defaults to full.
-
opt_param
-
string provisionalUserProject The project to be billed for this
request if the target bucket is requester-pays bucket.
-
opt_param
-
string userProject The project to be billed for this request, for
Requester Pays buckets.
Return values
Google_Service_Storage_StorageObject
—
rewrite()
Rewrites a source object to a destination object. Optionally overrides
metadata. (objects.rewrite)
public
rewrite(string $sourceBucket, string $sourceObject, string $destinationBucket, string $destinationObject, Google_Service_Storage_StorageObject $postBody[, array<string|int, mixed> $optParams = array() ]) : Google_Service_Storage_RewriteResponse
Parameters
-
$sourceBucket
: string
-
Name of the bucket in which to find the source
object.
-
$sourceObject
: string
-
Name of the source object. For information about
how to URL encode object names to be path safe, see Encoding URI Path Parts.
-
$destinationBucket
: string
-
Name of the bucket in which to store the new
object. Overrides the provided object metadata's bucket value, if any.
-
$destinationObject
: string
-
Name of the new object. Required when the
object metadata is not otherwise provided. Overrides the object metadata's
name value, if any. For information about how to URL encode object names to
be path safe, see Encoding URI Path Parts.
-
$postBody
: Google_Service_Storage_StorageObject
-
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
string destinationKmsKeyName Resource name of the Cloud KMS key,
of the form projects/my-project/locations/global/keyRings/my-kr/cryptoKeys
/my-key, that will be used to encrypt the object. Overrides the object
metadata's kms_key_name value, if any.
-
opt_param
-
string destinationPredefinedAcl Apply a predefined set of access
controls to the destination object.
-
opt_param
-
string ifGenerationMatch Makes the operation conditional on
whether the object's current generation matches the given value. Setting to 0
makes the operation succeed only if there are no live versions of the object.
-
opt_param
-
string ifGenerationNotMatch Makes the operation conditional on
whether the object's current generation does not match the given value. If no
live object exists, the precondition fails. Setting to 0 makes the operation
succeed only if there is a live version of the object.
-
opt_param
-
string ifMetagenerationMatch Makes the operation conditional on
whether the destination object's current metageneration matches the given
value.
-
opt_param
-
string ifMetagenerationNotMatch Makes the operation conditional on
whether the destination object's current metageneration does not match the
given value.
-
opt_param
-
string ifSourceGenerationMatch Makes the operation conditional on
whether the source object's current generation matches the given value.
-
opt_param
-
string ifSourceGenerationNotMatch Makes the operation conditional
on whether the source object's current generation does not match the given
value.
-
opt_param
-
string ifSourceMetagenerationMatch Makes the operation conditional
on whether the source object's current metageneration matches the given
value.
-
opt_param
-
string ifSourceMetagenerationNotMatch Makes the operation
conditional on whether the source object's current metageneration does not
match the given value.
-
opt_param
-
string maxBytesRewrittenPerCall The maximum number of bytes that
will be rewritten per rewrite request. Most callers shouldn't need to specify
this parameter - it is primarily in place to support testing. If specified
the value must be an integral multiple of 1 MiB (1048576). Also, this only
applies to requests where the source and destination span locations and/or
storage classes. Finally, this value must not change across rewrite calls
else you'll get an error that the rewriteToken is invalid.
-
opt_param
-
string projection Set of properties to return. Defaults to noAcl,
unless the object resource specifies the acl property, when it defaults to
full.
-
opt_param
-
string provisionalUserProject The project to be billed for this
request if the target bucket is requester-pays bucket.
-
opt_param
-
string rewriteToken Include this field (from the previous rewrite
response) on each rewrite request after the first one, until the rewrite
response 'done' flag is true. Calls that provide a rewriteToken can omit all
other request fields, but if included those fields must match the values
provided in the first rewrite request.
-
opt_param
-
string sourceGeneration If present, selects a specific revision of
the source object (as opposed to the latest version, the default).
-
opt_param
-
string userProject The project to be billed for this request.
Required for Requester Pays buckets.
Return values
Google_Service_Storage_RewriteResponse
—
setIamPolicy()
Updates an IAM policy for the specified object. (objects.setIamPolicy)
public
setIamPolicy(string $bucket, string $object, Google_Service_Storage_Policy $postBody[, array<string|int, mixed> $optParams = array() ]) : Google_Service_Storage_Policy
Parameters
-
$bucket
: string
-
Name of the bucket in which the object resides.
-
$object
: string
-
Name of the object. For information about how to URL
encode object names to be path safe, see Encoding URI Path Parts.
-
$postBody
: Google_Service_Storage_Policy
-
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
string generation If present, selects a specific revision of this
object (as opposed to the latest version, the default).
-
opt_param
-
string provisionalUserProject The project to be billed for this
request if the target bucket is requester-pays bucket.
-
opt_param
-
string userProject The project to be billed for this request.
Required for Requester Pays buckets.
Return values
Google_Service_Storage_Policy
—
testIamPermissions()
Tests a set of permissions on the given object to see which, if any, are held
by the caller. (objects.testIamPermissions)
public
testIamPermissions(string $bucket, string $object, string|array<string|int, mixed> $permissions[, array<string|int, mixed> $optParams = array() ]) : Google_Service_Storage_TestIamPermissionsResponse
Parameters
-
$bucket
: string
-
Name of the bucket in which the object resides.
-
$object
: string
-
Name of the object. For information about how to URL
encode object names to be path safe, see Encoding URI Path Parts.
-
$permissions
: string|array<string|int, mixed>
-
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
string generation If present, selects a specific revision of this
object (as opposed to the latest version, the default).
-
opt_param
-
string provisionalUserProject The project to be billed for this
request if the target bucket is requester-pays bucket.
-
opt_param
-
string userProject The project to be billed for this request.
Required for Requester Pays buckets.
Return values
Google_Service_Storage_TestIamPermissionsResponse
—
update()
Updates an object's metadata. (objects.update)
public
update(string $bucket, string $object, Google_Service_Storage_StorageObject $postBody[, array<string|int, mixed> $optParams = array() ]) : Google_Service_Storage_StorageObject
Parameters
-
$bucket
: string
-
Name of the bucket in which the object resides.
-
$object
: string
-
Name of the object. For information about how to URL
encode object names to be path safe, see Encoding URI Path Parts.
-
$postBody
: Google_Service_Storage_StorageObject
-
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
string generation If present, selects a specific revision of this
object (as opposed to the latest version, the default).
-
opt_param
-
string ifGenerationMatch Makes the operation conditional on
whether the object's current generation matches the given value. Setting to 0
makes the operation succeed only if there are no live versions of the object.
-
opt_param
-
string ifGenerationNotMatch Makes the operation conditional on
whether the object's current generation does not match the given value. If no
live object exists, the precondition fails. Setting to 0 makes the operation
succeed only if there is a live version of the object.
-
opt_param
-
string ifMetagenerationMatch Makes the operation conditional on
whether the object's current metageneration matches the given value.
-
opt_param
-
string ifMetagenerationNotMatch Makes the operation conditional on
whether the object's current metageneration does not match the given value.
-
opt_param
-
string predefinedAcl Apply a predefined set of access controls to
this object.
-
opt_param
-
string projection Set of properties to return. Defaults to full.
-
opt_param
-
string provisionalUserProject The project to be billed for this
request if the target bucket is requester-pays bucket.
-
opt_param
-
string userProject The project to be billed for this request.
Required for Requester Pays buckets.
Return values
Google_Service_Storage_StorageObject
—
watchAll()
Watch for changes on all objects in a bucket. (objects.watchAll)
public
watchAll(string $bucket, Google_Service_Storage_Channel $postBody[, array<string|int, mixed> $optParams = array() ]) : Google_Service_Storage_Channel
Parameters
-
$bucket
: string
-
Name of the bucket in which to look for objects.
-
$postBody
: Google_Service_Storage_Channel
-
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
string delimiter Returns results in a directory-like mode. items
will contain only objects whose names, aside from the prefix, do not contain
delimiter. Objects whose names, aside from the prefix, contain delimiter will
have their name, truncated after the delimiter, returned in prefixes.
Duplicate prefixes are omitted.
-
opt_param
-
string endOffset Filter results to objects whose names are
lexicographically before endOffset. If startOffset is also set, the objects
listed will have names between startOffset (inclusive) and endOffset
(exclusive).
-
opt_param
-
bool includeTrailingDelimiter If true, objects that end in exactly
one instance of delimiter will have their metadata included in items in
addition to prefixes.
-
opt_param
-
string maxResults Maximum number of items plus prefixes to return
in a single page of responses. As duplicate prefixes are omitted, fewer total
results may be returned than requested. The service will use this parameter
or 1,000 items, whichever is smaller.
-
opt_param
-
string pageToken A previously-returned page token representing
part of the larger set of results to view.
-
opt_param
-
string prefix Filter results to objects whose names begin with
this prefix.
-
opt_param
-
string projection Set of properties to return. Defaults to noAcl.
-
opt_param
-
string provisionalUserProject The project to be billed for this
request if the target bucket is requester-pays bucket.
-
opt_param
-
string startOffset Filter results to objects whose names are
lexicographically equal to or after startOffset. If endOffset is also set,
the objects listed will have names between startOffset (inclusive) and
endOffset (exclusive).
-
opt_param
-
string userProject The project to be billed for this request.
Required for Requester Pays buckets.
-
opt_param
-
bool versions If true, lists all versions of an object as distinct
results. The default is false. For more information, see Object Versioning.
Return values
Google_Service_Storage_Channel
—
convertToArrayAndStripNulls()
protected
convertToArrayAndStripNulls(mixed $o) : mixed
Parameters
-
$o
: mixed
-
Return values
mixed
—