AmazonS3Client Class Reference
| Inherits from | AmazonWebServiceClient : AmazonAbstractWebServiceClient : NSObject |
| Declared in | AmazonS3Client.h |
Overview
AmazonS3Client is an implementation of AmazonS3.
The client allows you to manage your AmazonS3 buckets and keys/objects.
Amazon S3 is storage for the Internet. It is designed to make web-scale computing easier for developers. Amazon S3 provides a simple web services interface that can be used to store and retrieve any amount of data, at any time, from anywhere on the web. It gives any developer access to the same highly scalable, reliable, fast, inexpensive data storage infrastructure that Amazon uses to run its own global network of web sites. The service aims to maximize benefits of scale and to pass those benefits on to developers.
Tasks
-
– listBuckets
Returns a list of all Amazon S3 buckets that the authenticated sender of the request owns.
-
– listBuckets:
Returns a list of all Amazon S3 buckets that the authenticated sender of the request owns.
-
– createBucket:
Creates a bucket using the the specified request object.
-
– createBucketWithName:
Creates a bucket using the the specified bucket name.
-
– deleteBucket:
Deletes a bucket with the specified name. All objects in the bucket must be deleted before the bucket itself can be deleted.
-
– deleteBucketWithName:
Deletes a bucket with the specified name. All objects in the bucket must be deleted before the bucket itself can be deleted.
-
– getBucketLocation:
Takes in a bucket’s name and lists the location of the bucket. This information can be used to determine the bucket’s geographical location. To determine the location of a bucket, you must be the bucket owner
-
– getObjectMetadata:
Retrieve metadata from an object without returning the object itself.
-
– putObject:
Upload an object to S3.
-
– getObject:
Fetch the most recent version of an S3 object from the specified S3 bucket. You must have READ access to the object. If READ access is granted to an anonymous user, an object can be retrieved without an authorization header. Providing a version-id for the object will fetch the specific version from S3 instead of the most recent one.
-
– deleteObject:
Removes the specified object from Amazon S3. Once deleted, there is no method to restore or undelete an object.
-
– deleteObjects:
Removes the specified objects from Amazon S3. Once deleted, there is no method to restore or undelete an object. Check S3DeleteObjectsResponse.deleteErrors to see if there were any errors after calling this method. – When there was no error, deleteErrors will be an empty NSArray. – When there were any errors, deleteErrors contains a list of DeleteError objects.
-
– deleteObjectWithKey:withBucket:
Removes the specified object from Amazon S3. Once deleted, there is no method to restore or undelete an object.
-
– listObjects:
List the objects in a bucket.
-
– listObjectsInBucket:
List the objects in a bucket.
-
– copyObject:
Create a copy of an object that is already stored in Amazon S3. When copying an object, you can preserve all metadata (default) or specify new metadata. However, the ACL is not preserved and is set to private for the user making the request. To override the default ACL setting, specify a new ACL when generating a copy request.
-
– getACL:
Gets the access control list for a given bucket or object.
-
– setACL:
Sets the S3AccessControlList for a given bucket or object.
-
– getBucketPolicy:
Gets the policy for the specified bucket. Only the owner of the bucket can retrieve the policy. If no policy has been set for the bucket, then an empty result object with a
null
policy text field will be returned. -
– setBucketPolicy:
Sets the policy associated with the specified bucket. Only the owner of the bucket can set a bucket policy. If a policy already exists for the specified bucket, the new policy replaces the existing policy.
-
– deleteBucketPolicy:
Deletes the policy associated with the specified bucket. Only the owner of the bucket can delete the bucket policy.
-
– getBucketVersioningConfiguration:
Returns the versioning configuration for the specified bucket. A bucket’s versioning configuration can be in one of three possible states: Off, Enabled, or Suspended
-
– setBucketVersioningConfiguration:
Sets the versioning configuration for the specified bucket. A bucket’s versioning configuration can be in one of three possible states: Off, Enabled, or Suspended
-
– setBucketWebsiteConfiguration:
Sets the website configuration for the specified bucket. Bucket website configuration allows you to host your static websites entirely out of Amazon S3. To host your website in Amazon S3, create a bucket, upload your files, and configure it as a website. Once your bucket has been configured as a website, you can access all your content via the Amazon S3 website endpoint. To ensure that the existing Amazon S3 REST API will continue to behave the same, regardless of whether or not your bucket has been configured to host a website, a new HTTP endpoint has been introduced where you can access your content. The bucket content you want to make available via the website must be publicly readable.
For more information on how to host a website on Amazon S3, see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/WebsiteHosting.html.
This operation requires the
S3:PutBucketWebsite
permission. By default, only the bucket owner can configure the website attached to a bucket. However, bucket owners can allow other users to set the website configuration by writing a bucket policy granting them theS3:PutBucketWebsite
permission. -
– getBucketWebsiteConfiguration:
Returns the website configuration for the specified bucket. Bucket website configuration allows you to host your static websites entirely out of Amazon S3. To host your website in Amazon S3, create a bucket, upload your files, and configure it as a website. Once your bucket has been configured as a website, you can access all your content via the Amazon S3 website endpoint. To ensure that the existing Amazon S3 REST API will continue to behave the same, regardless of whether or not your bucket has been configured to host a website, a new HTTP endpoint has been introduced where you can access your content. The bucket content you want to make available via the website must be publicly readable.
For more information on how to host a website on Amazon S3, see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/WebsiteHosting.html.
This operation requires the
S3:GetBucketWebsite
permission. By default, only the bucket owner can read the bucket website configuration. However, bucket owners can allow other users to read the website configuration by writing a bucket policy granting them theS3:GetBucketWebsite
permission. -
– deleteBucketWebsiteConfiguration:
This operation removes the website configuration for a bucket. Calling this operation on a bucket with no website configuration does not throw an exception. Calling this operation a bucket that does not exist will throw an exception.
For more information on how to host a website on Amazon S3, see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/WebsiteHosting.html.
This operation requires the
S3:DeleteBucketWebsite
permission. By default, only the bucket owner can delete the website configuration attached to a bucket. However, bucket owners can grant other users permission to delete the website configuration by writing a bucket policy granting them theS3:DeleteBucketWebsite
permission. -
– setBucketLifecycleConfiguration:
Sets the lifecycle configuration for the specified bucket. Bucket lifecycle configuration allows you specify a number of rules for object based on the object’s key prefix. Each rule is a combination of id, prefix status and expiration time (in days).
For more informaiton on how to use Bucket Lifecycle/Object Expiration see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/ObjectExpiration.html.
-
– getBucketLifecycleConfiguration:
Returns the the lifecycle configuration for the specified bucket. Bucket lifecycle configuration allows you specify a number of rules for object based on the object’s key prefix. Each rule is a combination of id, prefix status and expiration time (in days).
For more informaiton on how to use Bucket Lifecycle/Object Expiration see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/ObjectExpiration.html.
-
– deleteBucketLifecycleConfiguration:
This operation removes the lifecycle configuration for a bucket. Calling this operation on a bucket with no lifecycle configuration does not throw an exception. Calling this operation on a bucket that does not exist will throw an exception.
For more informaiton on how to use Bucket Lifecycle/Object Expiration see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/ObjectExpiration.html.
-
– setBucketTagging:
Sets the tagging configuration for the specified bucket. A tagging configuration contains a TagSet.
For more informaiton on how to using Bucket Cost Allocation Tagging see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/BucketBilling.html.
-
– getBucketTagging:
Gets the tagging configuration for the specified bucket, or null if no configuration has been established.
For more informaiton on how to using Bucket Cost Allocation Tagging see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/BucketBilling.html.
-
– deleteBucketTagging:
Deletes the tagging configuration for the specified bucket
For more informaiton on how to using Bucket Cost Allocation Tagging see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/BucketBilling.html.
-
– setBucketCrossOrigin:
Sets the CORS configuration for the specified bucket, or null if no configuration has been established. CORS config is comprised of a set of rules.
For more informaiton on how to using Bucket CORS see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/cors.html.
-
– getBucketCrossOrigin:
Gets the CrossOrigin configuration for the specified bucket, or null if no configuration has been established.
For more informaiton on how to using Bucket CORS see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/cors.html.
-
– deleteBucketCrossOrigin:
Deletes the CrossOrigin configuration for the specified bucket
For more informaiton on how to using Bucket CORS see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/cors.html.
-
– deleteVersion:
Deletes a specific version of an object in the specified bucket. Once deleted, there is no method to restore or undelete an object version. This is the only way to permanently delete object versions that are protected by versioning.
-
– listVersions:
Returns a list of summary information about the versions in the specified bucket.
-
– initiateMultipartUpload:
Initiates a multipart upload and returns an InitiateMultipartUploadResponse.
-
– initiateMultipartUploadWithKey:withBucket:
Initiates a multipart upload and returns an MultipartUpload instance which contains an upload ID. This upload ID associates all the parts in the specific upload. You specify this upload ID in each of your subsequent Upload Part requests. You also include this upload ID in the final request to either complete, or abort the multipart upload request.
-
– abortMultipartUpload:
Aborts a multipart upload. After a multipart upload is aborted, no additional parts can be uploaded using that upload ID. The storage consumed by any previously uploaded parts will be freed. However, if any part uploads are currently in progress, those part uploads might or might not succeed. As a result, it might be necessary to abort a given multipart upload multiple times in order to completely free all storage consumed by all parts.
-
– listMultipartUploads:
This operation lists in-progress multipart uploads. An in-progress multipart upload is a multipart upload that has been initiated, using the InitiateMultipartUpload request, but has not yet been completed or aborted.
-
– uploadPart:
Uploads a part in a multipart upload. You must initiate a multipart upload before you can upload any part.
-
– listParts:
Lists the parts that have been uploaded for a particular multipart upload.
-
– copyPart:
S3CopyPartResponse
-
– completeMultipartUpload:
Completes a multipart upload by assembling previously uploaded parts. You first upload all parts using the uploadPart method.  Upon receiving this request, Amazon S3 concatenates all the parts in ascending order by part number to create a new object. In the completeMultipartUpload request, you must provide the parts list. For each part in the list, you provide the part number and the ETag header value, returned after that part was uploaded. Processing of a completeMultipartUpload request may take several minutes to complete.
-
– getPreSignedURL:
Creates a signed http request. Query string authentication is useful for giving HTTP or browser access to resources that would normally require authentication. When using query string authentication, you create a query, specify an expiration time for the query, sign it with your signature, place the data in an HTTP request, and distribute the request to a user or embed the request in a web page. A PreSigned URL can be generated for GET, PUT and HEAD operations on your bucket, and keys.
-
– getPreSignedURL:error:
Creates a signed http request. Query string authentication is useful for giving HTTP or browser access to resources that would normally require authentication. When using query string authentication, you create a query, specify an expiration time for the query, sign it with your signature, place the data in an HTTP request, and distribute the request to a user or embed the request in a web page. A PreSigned URL can be generated for GET, PUT and HEAD operations on your bucket, and keys.
-
+ constructResponseFromRequest:
Constructs an empty response object of the appropriate type to match the given request object.
-
– invoke:
Utility method that sends the raw S3 Request to be processed.
-
+ apiVersion
Return the version of the S3 API
-
+ initializeResponseObjects
Ensure that all response classes have been loaded by the runtime.
Class Methods
apiVersion
Return the version of the S3 API
+ (NSString *)apiVersion
Discussion
Return the version of the S3 API
Declared In
AmazonS3Client.h
constructResponseFromRequest:
Constructs an empty response object of the appropriate type to match the given request object.
+ (S3Response *)constructResponseFromRequest:(S3Request *)request
Parameters
- request
An instance of a subclass of S3Request.
Return Value
An instance of the appropriate subclass of S3Response, or an instance of S3Response if there is no response class to match the instance passed in.
Discussion
Constructs an empty response object of the appropriate type to match the given request object.
Declared In
AmazonS3Client.h
Instance Methods
abortMultipartUpload:
Aborts a multipart upload. After a multipart upload is aborted, no additional parts can be uploaded using that upload ID. The storage consumed by any previously uploaded parts will be freed. However, if any part uploads are currently in progress, those part uploads might or might not succeed. As a result, it might be necessary to abort a given multipart upload multiple times in order to completely free all storage consumed by all parts.
- (S3AbortMultipartUploadResponse *)abortMultipartUpload:(S3AbortMultipartUploadRequest *)abortMultipartUploadRequest
Parameters
- abortMultipartUploadRequest
The S3AbortMultipartUploadRequest which defines the parameters of the operation.
Return Value
An S3AbortMultipartUploadResponse from S3.
Discussion
Aborts a multipart upload. After a multipart upload is aborted, no additional parts can be uploaded using that upload ID. The storage consumed by any previously uploaded parts will be freed. However, if any part uploads are currently in progress, those part uploads might or might not succeed. As a result, it might be necessary to abort a given multipart upload multiple times in order to completely free all storage consumed by all parts.
Declared In
AmazonS3Client.h
completeMultipartUpload:
Completes a multipart upload by assembling previously uploaded parts. You first upload all parts using the uploadPart method.  Upon receiving this request, Amazon S3 concatenates all the parts in ascending order by part number to create a new object. In the completeMultipartUpload request, you must provide the parts list. For each part in the list, you provide the part number and the ETag header value, returned after that part was uploaded. Processing of a completeMultipartUpload request may take several minutes to complete.
- (S3CompleteMultipartUploadResponse *)completeMultipartUpload:(S3CompleteMultipartUploadRequest *)completeMultipartUploadRequest
Parameters
- completeMultipartUploadRequest
The CompleteMultipartUploadRequest that defines the parameters of the operation.
Return Value
An S3CompleteMultipartUploadResponse from S3.
Discussion
Completes a multipart upload by assembling previously uploaded parts. You first upload all parts using the uploadPart method.  Upon receiving this request, Amazon S3 concatenates all the parts in ascending order by part number to create a new object. In the completeMultipartUpload request, you must provide the parts list. For each part in the list, you provide the part number and the ETag header value, returned after that part was uploaded. Processing of a completeMultipartUpload request may take several minutes to complete.
Declared In
AmazonS3Client.h
copyObject:
Create a copy of an object that is already stored in Amazon S3. When copying an object, you can preserve all metadata (default) or specify new metadata. However, the ACL is not preserved and is set to private for the user making the request. To override the default ACL setting, specify a new ACL when generating a copy request.
- (S3CopyObjectResponse *)copyObject:(S3CopyObjectRequest *)copyObjectRequest
Discussion
Create a copy of an object that is already stored in Amazon S3. When copying an object, you can preserve all metadata (default) or specify new metadata. However, the ACL is not preserved and is set to private for the user making the request. To override the default ACL setting, specify a new ACL when generating a copy request.
See Also
Declared In
AmazonS3Client.h
copyPart:
S3CopyPartResponse
- (S3CopyPartResponse *)copyPart:(S3CopyPartRequest *)copyPartRequest
See Also
Declared In
AmazonS3Client.h
createBucket:
Creates a bucket using the the specified request object.
- (S3CreateBucketResponse *)createBucket:(S3CreateBucketRequest *)createBucketRequest
Parameters
- createBucketRequest
An S3CreateBucketRequest that defines the parameters of the request.
Return Value
An S3CreateBucketResponse from S3
Discussion
Creates a bucket using the the specified request object.
Declared In
AmazonS3Client.h
createBucketWithName:
Creates a bucket using the the specified bucket name.
- (S3CreateBucketResponse *)createBucketWithName:(NSString *)bucketName
Parameters
- bucketName
The name for the bucket to be created.
Return Value
An S3CreateBucketResponse from S3
Discussion
Creates a bucket using the the specified bucket name.
See Also
Declared In
AmazonS3Client.h
deleteBucket:
Deletes a bucket with the specified name. All objects in the bucket must be deleted before the bucket itself can be deleted.
- (S3DeleteBucketResponse *)deleteBucket:(S3DeleteBucketRequest *)deleteBucketRequest
Parameters
- deleteBucketRequest
An S3DeleteBucketRequest that defines the parameters of the request.
Return Value
An S3DeleteBucketResponse from S3
Discussion
Deletes a bucket with the specified name. All objects in the bucket must be deleted before the bucket itself can be deleted.
Declared In
AmazonS3Client.h
deleteBucketCrossOrigin:
Deletes the CrossOrigin configuration for the specified bucket
For more informaiton on how to using Bucket CORS see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/cors.html.
- (S3DeleteBucketCrossOriginResponse *)deleteBucketCrossOrigin:(S3DeleteBucketCrossOriginRequest *)deleteBucketCrossOriginRequest
Parameters
- deleteBucketCrossOriginRequest
the request to process
Discussion
Deletes the CrossOrigin configuration for the specified bucket
For more informaiton on how to using Bucket CORS see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/cors.html.
Exceptions
- AmazonClientException
If any errors are encountered on the client while making the request or handling the response. For more information see AmazonClientException.
- AmazonServiceException
If any errors occurred in Amazon S3 while processing the request. For more information see AmazonServiceException.
Declared In
AmazonS3Client.h
deleteBucketLifecycleConfiguration:
This operation removes the lifecycle configuration for a bucket. Calling this operation on a bucket with no lifecycle configuration does not throw an exception. Calling this operation on a bucket that does not exist will throw an exception.
For more informaiton on how to use Bucket Lifecycle/Object Expiration see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/ObjectExpiration.html.
- (S3DeleteBucketLifecycleConfigurationResponse *)deleteBucketLifecycleConfiguration:(S3DeleteBucketLifecycleConfigurationRequest *)deleteBucketLifecycleConfigurationRequest
Parameters
- deleteBucketLifecycleConfigurationRequest
The request to process
Discussion
This operation removes the lifecycle configuration for a bucket. Calling this operation on a bucket with no lifecycle configuration does not throw an exception. Calling this operation on a bucket that does not exist will throw an exception.
For more informaiton on how to use Bucket Lifecycle/Object Expiration see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/ObjectExpiration.html.
Exceptions
- AmazonClientException
If any errors are encountered on the client while making the request or handling the response. For more information see AmazonClientException.
- AmazonServiceException
If any errors occurred in Amazon S3 while processing the request. For more information see AmazonServiceException.
Declared In
AmazonS3Client.h
deleteBucketPolicy:
Deletes the policy associated with the specified bucket. Only the owner of the bucket can delete the bucket policy.
- (S3DeleteBucketPolicyResponse *)deleteBucketPolicy:(S3DeleteBucketPolicyRequest *)deletePolicyRequest
Discussion
Deletes the policy associated with the specified bucket. Only the owner of the bucket can delete the bucket policy.
Bucket policies provide access control management at the bucket level for both the bucket resource and contained object resources. Only one policy can be specified per-bucket.
Declared In
AmazonS3Client.h
deleteBucketTagging:
Deletes the tagging configuration for the specified bucket
For more informaiton on how to using Bucket Cost Allocation Tagging see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/BucketBilling.html.
- (S3DeleteBucketTaggingResponse *)deleteBucketTagging:(S3DeleteBucketTaggingRequest *)deleteBucketTaggingRequest
Parameters
- deleteBucketTaggingRequest
The request to process
Discussion
Deletes the tagging configuration for the specified bucket
For more informaiton on how to using Bucket Cost Allocation Tagging see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/BucketBilling.html.
Exceptions
- AmazonClientException
If any errors are encountered on the client while making the request or handling the response. For more information see AmazonClientException.
- AmazonServiceException
If any errors occurred in Amazon S3 while processing the request. For more information see AmazonServiceException.
Declared In
AmazonS3Client.h
deleteBucketWebsiteConfiguration:
This operation removes the website configuration for a bucket. Calling this operation on a bucket with no website configuration does not throw an exception. Calling this operation a bucket that does not exist will throw an exception.
For more information on how to host a website on Amazon S3, see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/WebsiteHosting.html.
This operation requires the S3:DeleteBucketWebsite
permission. By default, only the bucket owner can delete the website
configuration attached to a bucket. However, bucket owners can grant
other users permission to delete the website configuration by writing a
bucket policy granting them the S3:DeleteBucketWebsite
permission.
- (S3DeleteBucketWebsiteConfigurationResponse *)deleteBucketWebsiteConfiguration:(S3DeleteBucketWebsiteConfigurationRequest *)deleteBucketWebsiteConfigurationRequest
Parameters
- bucketName
The name of the bucket whose website configuration is being deleted.
Discussion
This operation removes the website configuration for a bucket. Calling this operation on a bucket with no website configuration does not throw an exception. Calling this operation a bucket that does not exist will throw an exception.
For more information on how to host a website on Amazon S3, see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/WebsiteHosting.html.
This operation requires the S3:DeleteBucketWebsite
permission. By default, only the bucket owner can delete the website
configuration attached to a bucket. However, bucket owners can grant
other users permission to delete the website configuration by writing a
bucket policy granting them the S3:DeleteBucketWebsite
permission.
Exceptions
- AmazonClientException
If any errors are encountered on the client while making the request or handling the response. For more information see AmazonClientException.
- AmazonServiceException
If any errors occurred in Amazon S3 while processing the request. For more information see AmazonServiceException.
Declared In
AmazonS3Client.h
deleteBucketWithName:
Deletes a bucket with the specified name. All objects in the bucket must be deleted before the bucket itself can be deleted.
- (S3DeleteBucketResponse *)deleteBucketWithName:(NSString *)bucketName
Parameters
- bucketName
The name of the bucket to be deleted.
Return Value
An S3DeleteBucketResponse from S3
Discussion
Deletes a bucket with the specified name. All objects in the bucket must be deleted before the bucket itself can be deleted.
See Also
Declared In
AmazonS3Client.h
deleteObject:
Removes the specified object from Amazon S3. Once deleted, there is no method to restore or undelete an object.
- (S3DeleteObjectResponse *)deleteObject:(S3DeleteObjectRequest *)deleteObjectRequest
Parameters
- deleteObjectRequest
The S3DeleteObjectRequest that defines the parameters of the operation.
Return Value
An S3DeleteObjectResponse from S3.
Discussion
Removes the specified object from Amazon S3. Once deleted, there is no method to restore or undelete an object.
Declared In
AmazonS3Client.h
deleteObjectWithKey:withBucket:
Removes the specified object from Amazon S3. Once deleted, there is no method to restore or undelete an object.
- (S3DeleteObjectResponse *)deleteObjectWithKey:(NSString *)theKey withBucket:(NSString *)theBucket
Parameters
- theKey
The key of the object to be deleted.
- theBucket
The bucket containing the object to be deleted.
Return Value
An S3DeleteObjectResponse from S3.
Discussion
Removes the specified object from Amazon S3. Once deleted, there is no method to restore or undelete an object.
See Also
Declared In
AmazonS3Client.h
deleteObjects:
Removes the specified objects from Amazon S3. Once deleted, there is no method to restore or undelete an object. Check S3DeleteObjectsResponse.deleteErrors to see if there were any errors after calling this method. – When there was no error, deleteErrors will be an empty NSArray. – When there were any errors, deleteErrors contains a list of DeleteError objects.
- (S3DeleteObjectsResponse *)deleteObjects:(S3DeleteObjectsRequest *)deleteObjectsRequest
Parameters
- deleteObjectsRequest
The S3DeleteObjectsRequest that defines the parameters of the operation.
Return Value
An S3DeleteObjectsResponse from S3.
Discussion
Removes the specified objects from Amazon S3. Once deleted, there is no method to restore or undelete an object. Check S3DeleteObjectsResponse.deleteErrors to see if there were any errors after calling this method. – When there was no error, deleteErrors will be an empty NSArray. – When there were any errors, deleteErrors contains a list of DeleteError objects.
Declared In
AmazonS3Client.h
deleteVersion:
Deletes a specific version of an object in the specified bucket. Once deleted, there is no method to restore or undelete an object version. This is the only way to permanently delete object versions that are protected by versioning.
- (S3DeleteVersionResponse *)deleteVersion:(S3DeleteVersionRequest *)deleteVersionRequest
Discussion
Deletes a specific version of an object in the specified bucket. Once deleted, there is no method to restore or undelete an object version. This is the only way to permanently delete object versions that are protected by versioning.
Deleting an object version is permanent and irreversible. It is a privileged operation that only the owner of the bucket containing the version can perform.
Declared In
AmazonS3Client.h
getACL:
Gets the access control list for a given bucket or object.
- (S3GetACLResponse *)getACL:(S3GetACLRequest *)getACLRequest
Parameters
- getACLRequest
The S3GetACLRequest that defines the parameters of the operation.
Return Value
An S3GetACLResponse from S3.
Discussion
Gets the access control list for a given bucket or object.
See Also
Declared In
AmazonS3Client.h
getBucketCrossOrigin:
Gets the CrossOrigin configuration for the specified bucket, or null if no configuration has been established.
For more informaiton on how to using Bucket CORS see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/cors.html.
- (S3GetBucketCrossOriginResponse *)getBucketCrossOrigin:(S3GetBucketCrossOriginRequest *)getBucketCrossOriginRequest
Parameters
- getBucketCrossOriginRequest
request to process
Return Value
A response which will contain the CORS config for bucket.
Discussion
Gets the CrossOrigin configuration for the specified bucket, or null if no configuration has been established.
For more informaiton on how to using Bucket CORS see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/cors.html.
Exceptions
- AmazonClientException
If any errors are encountered on the client while making the request or handling the response. For more information see AmazonClientException.
- AmazonServiceException
If any errors occurred in Amazon S3 while processing the request. For more information see AmazonServiceException.
Declared In
AmazonS3Client.h
getBucketLifecycleConfiguration:
Returns the the lifecycle configuration for the specified bucket. Bucket lifecycle configuration allows you specify a number of rules for object based on the object’s key prefix. Each rule is a combination of id, prefix status and expiration time (in days).
For more informaiton on how to use Bucket Lifecycle/Object Expiration see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/ObjectExpiration.html.
- (S3GetBucketLifecycleConfigurationResponse *)getBucketLifecycleConfiguration:(S3GetBucketLifecycleConfigurationRequest *)getBucketLifecycleConfigurationRequest
Parameters
- getBucketLifecycleConfigurationRequest
The request to process
Return Value
The bucket lifecycle configuration for the specified bucket, otherwise null if there is no Lifecycle configuration set for the specified bucket.
Discussion
Returns the the lifecycle configuration for the specified bucket. Bucket lifecycle configuration allows you specify a number of rules for object based on the object’s key prefix. Each rule is a combination of id, prefix status and expiration time (in days).
For more informaiton on how to use Bucket Lifecycle/Object Expiration see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/ObjectExpiration.html.
Exceptions
- AmazonClientException
If any errors are encountered on the client while making the request or handling the response. For more information see AmazonClientException.
- AmazonServiceException
If any errors occurred in Amazon S3 while processing the request. For more information see AmazonServiceException.
Declared In
AmazonS3Client.h
getBucketLocation:
Takes in a bucket’s name and lists the location of the bucket. This information can be used to determine the bucket’s geographical location. To determine the location of a bucket, you must be the bucket owner
- (S3Region *)getBucketLocation:(NSString *)bucketName
Parameters
- bucketName
The name of the bucket.
Return Value
The S3Region object that represents the region.
Discussion
Takes in a bucket’s name and lists the location of the bucket. This information can be used to determine the bucket’s geographical location. To determine the location of a bucket, you must be the bucket owner
See Also
Declared In
AmazonS3Client.h
getBucketPolicy:
Gets the policy for the specified bucket. Only the owner of the
bucket can retrieve the policy. If no policy has been set for the bucket,
then an empty result object with a null
policy text field will be
returned.
- (S3GetBucketPolicyResponse *)getBucketPolicy:(S3GetBucketPolicyRequest *)getPolicyRequest
Discussion
Gets the policy for the specified bucket. Only the owner of the
bucket can retrieve the policy. If no policy has been set for the bucket,
then an empty result object with a null
policy text field will be
returned.
Bucket policies provide access control management at the bucket level for both the bucket resource and contained object resources. Only one policy can be specified per-bucket.
Declared In
AmazonS3Client.h
getBucketTagging:
Gets the tagging configuration for the specified bucket, or null if no configuration has been established.
For more informaiton on how to using Bucket Cost Allocation Tagging see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/BucketBilling.html.
- (S3GetBucketTaggingResponse *)getBucketTagging:(S3GetBucketTaggingRequest *)getBucketTaggingRequest
Parameters
- getBucketTaggingRequest
The request to process
Return Value
The bucket lifecycle configuration for the specified bucket, otherwise null if there is no Lifecycle configuration set for the specified bucket.
Discussion
Gets the tagging configuration for the specified bucket, or null if no configuration has been established.
For more informaiton on how to using Bucket Cost Allocation Tagging see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/BucketBilling.html.
Exceptions
- AmazonClientException
If any errors are encountered on the client while making the request or handling the response. For more information see AmazonClientException.
- AmazonServiceException
If any errors occurred in Amazon S3 while processing the request. For more information see AmazonServiceException.
Declared In
AmazonS3Client.h
getBucketVersioningConfiguration:
Returns the versioning configuration for the specified bucket. A bucket’s versioning configuration can be in one of three possible states: Off, Enabled, or Suspended
- (S3GetBucketVersioningConfigurationResponse *)getBucketVersioningConfiguration:(S3GetBucketVersioningConfigurationRequest *)getBucketVersioningConfigurationRequest
Discussion
Returns the versioning configuration for the specified bucket. A bucket’s versioning configuration can be in one of three possible states: Off, Enabled, or Suspended
By default, new buckets are in the Off state. Once versioning is enabled for a bucket the status can never be reverted to Off.
The versioning configuration of a bucket has different implications for
each operation performed on that bucket or for objects within that
bucket. For example, when versioning is enabled a PutObject
operation creates a unique object version-id for the object being uploaded. The
The PutObject
API guarantees that, if versioning is enabled for a bucket at
the time of the request, the new object can only be permanently deleted
using a DeleteVersion
operation. It can never be overwritten.
Additionally, the PutObject
API guarantees that,
if versioning is enabled for a bucket the request,
no other object will be overwritten by that request.
Refer to the documentation sections for each API for information on how
versioning status affects the semantics of that particular API.
Declared In
AmazonS3Client.h
getBucketWebsiteConfiguration:
Returns the website configuration for the specified bucket. Bucket website configuration allows you to host your static websites entirely out of Amazon S3. To host your website in Amazon S3, create a bucket, upload your files, and configure it as a website. Once your bucket has been configured as a website, you can access all your content via the Amazon S3 website endpoint. To ensure that the existing Amazon S3 REST API will continue to behave the same, regardless of whether or not your bucket has been configured to host a website, a new HTTP endpoint has been introduced where you can access your content. The bucket content you want to make available via the website must be publicly readable.
For more information on how to host a website on Amazon S3, see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/WebsiteHosting.html.
This operation requires the S3:GetBucketWebsite
permission.
By default, only the bucket owner can read the bucket website
configuration. However, bucket owners can allow other users to read the
website configuration by writing a bucket policy granting them the
S3:GetBucketWebsite
permission.
- (S3GetBucketWebsiteConfigurationResponse *)getBucketWebsiteConfiguration:(S3GetBucketWebsiteConfigurationRequest *)getBucketWebsiteConfigurationRequest
Parameters
- bucketName
The name of the bucket whose website configuration is being retrieved.
Return Value
The bucket website configuration for the specified bucket, otherwise null if there is no website configuration set for the specified bucket.
Discussion
Returns the website configuration for the specified bucket. Bucket website configuration allows you to host your static websites entirely out of Amazon S3. To host your website in Amazon S3, create a bucket, upload your files, and configure it as a website. Once your bucket has been configured as a website, you can access all your content via the Amazon S3 website endpoint. To ensure that the existing Amazon S3 REST API will continue to behave the same, regardless of whether or not your bucket has been configured to host a website, a new HTTP endpoint has been introduced where you can access your content. The bucket content you want to make available via the website must be publicly readable.
For more information on how to host a website on Amazon S3, see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/WebsiteHosting.html.
This operation requires the S3:GetBucketWebsite
permission.
By default, only the bucket owner can read the bucket website
configuration. However, bucket owners can allow other users to read the
website configuration by writing a bucket policy granting them the
S3:GetBucketWebsite
permission.
Exceptions
- AmazonClientException
If any errors are encountered on the client while making the request or handling the response. For more information see AmazonClientException.
- AmazonServiceException
If any errors occurred in Amazon S3 while processing the request. For more information see AmazonServiceException.
Declared In
AmazonS3Client.h
getObject:
Fetch the most recent version of an S3 object from the specified S3 bucket. You must have READ access to the object. If READ access is granted to an anonymous user, an object can be retrieved without an authorization header. Providing a version-id for the object will fetch the specific version from S3 instead of the most recent one.
- (S3GetObjectResponse *)getObject:(S3GetObjectRequest *)getObjectRequest
Parameters
- getObjectRequest
The S3GetObjectRequest that defines the parameters of the request.
Return Value
An S3GetObjectResponse from S3.
Discussion
Fetch the most recent version of an S3 object from the specified S3 bucket. You must have READ access to the object. If READ access is granted to an anonymous user, an object can be retrieved without an authorization header. Providing a version-id for the object will fetch the specific version from S3 instead of the most recent one.
See Also
Declared In
AmazonS3Client.h
getObjectMetadata:
Retrieve metadata from an object without returning the object itself.
- (S3GetObjectMetadataResponse *)getObjectMetadata:(S3GetObjectMetadataRequest *)getObjectMetadataRequest
Parameters
- getObjectMetadataRequest
The S3DeleteBucketRequest object that defines the parameters of the request.
Return Value
An S3GetObjectMetadataResponse from S3.
Discussion
Retrieve metadata from an object without returning the object itself.
Declared In
AmazonS3Client.h
getPreSignedURL:
Creates a signed http request. Query string authentication is useful for giving HTTP or browser access to resources that would normally require authentication. When using query string authentication, you create a query, specify an expiration time for the query, sign it with your signature, place the data in an HTTP request, and distribute the request to a user or embed the request in a web page. A PreSigned URL can be generated for GET, PUT and HEAD operations on your bucket, and keys.
- (NSURL *)getPreSignedURL:(S3GetPreSignedURLRequest *)preSignedURLRequest
Parameters
- preSignedURLRequest
The S3GetPreSignedURLRequest that defines the parameters of the operation.
Return Value
An signed NSURL for the resource.
Discussion
Creates a signed http request. Query string authentication is useful for giving HTTP or browser access to resources that would normally require authentication. When using query string authentication, you create a query, specify an expiration time for the query, sign it with your signature, place the data in an HTTP request, and distribute the request to a user or embed the request in a web page. A PreSigned URL can be generated for GET, PUT and HEAD operations on your bucket, and keys.
See Also
Declared In
AmazonS3Client.h
getPreSignedURL:error:
Creates a signed http request. Query string authentication is useful for giving HTTP or browser access to resources that would normally require authentication. When using query string authentication, you create a query, specify an expiration time for the query, sign it with your signature, place the data in an HTTP request, and distribute the request to a user or embed the request in a web page. A PreSigned URL can be generated for GET, PUT and HEAD operations on your bucket, and keys.
- (NSURL *)getPreSignedURL:(S3GetPreSignedURLRequest *)preSignedURLRequest error:(NSError **)error
Parameters
- preSignedURLRequest
The S3GetPreSignedURLRequest that defines the parameters of the operation.
- error
A reference to an NSError object.
Return Value
An signed NSURL for the resource.
Discussion
Creates a signed http request. Query string authentication is useful for giving HTTP or browser access to resources that would normally require authentication. When using query string authentication, you create a query, specify an expiration time for the query, sign it with your signature, place the data in an HTTP request, and distribute the request to a user or embed the request in a web page. A PreSigned URL can be generated for GET, PUT and HEAD operations on your bucket, and keys.
See Also
Declared In
AmazonS3Client.h
initiateMultipartUpload:
Initiates a multipart upload and returns an InitiateMultipartUploadResponse.
- (S3InitiateMultipartUploadResponse *)initiateMultipartUpload:(S3InitiateMultipartUploadRequest *)initiateMultipartUploadRequest
Parameters
- initiateMultipartUploadRequest
The S3InitiateMultipartUploadRequest that defines the paramaters of the operation.
Discussion
Initiates a multipart upload and returns an InitiateMultipartUploadResponse.
Declared In
AmazonS3Client.h
initiateMultipartUploadWithKey:withBucket:
Initiates a multipart upload and returns an MultipartUpload instance which contains an upload ID. This upload ID associates all the parts in the specific upload. You specify this upload ID in each of your subsequent Upload Part requests. You also include this upload ID in the final request to either complete, or abort the multipart upload request.
- (S3MultipartUpload *)initiateMultipartUploadWithKey:(NSString *)theKey withBucket:(NSString *)theBucket
Parameters
- theKey
The key the the completed object will have
- theBucket
The bucket where the completed object will reside.
Return Value
An S3MultipartUpload object which contains the uploadId for the upload.
Discussion
Initiates a multipart upload and returns an MultipartUpload instance which contains an upload ID. This upload ID associates all the parts in the specific upload. You specify this upload ID in each of your subsequent Upload Part requests. You also include this upload ID in the final request to either complete, or abort the multipart upload request.
See Also
Declared In
AmazonS3Client.h
invoke:
Utility method that sends the raw S3 Request to be processed.
- (S3Response *)invoke:(S3Request *)request
Parameters
- request
A request describing the parameters of an S3 request.
Return Value
The response from S3.
Discussion
Utility method that sends the raw S3 Request to be processed.
Declared In
AmazonS3Client.h
listBuckets
Returns a list of all Amazon S3 buckets that the authenticated sender of the request owns.
- (NSArray *)listBuckets
Return Value
An NSArray of S3Bucket objects.
Discussion
Returns a list of all Amazon S3 buckets that the authenticated sender of the request owns.
Declared In
AmazonS3Client.h
listBuckets:
Returns a list of all Amazon S3 buckets that the authenticated sender of the request owns.
- (S3ListBucketsResponse *)listBuckets:(S3ListBucketsRequest *)listBucketsRequest
Parameters
- listBucketsRequest
An S3ListBucketsRequest object that defines the parameters of the request.
Return Value
An S3ListBucketsResponse from S3. The buckets
property of the
S3ListBucketsResult has the list of buckets.
Discussion
Returns a list of all Amazon S3 buckets that the authenticated sender of the request owns.
Declared In
AmazonS3Client.h
listMultipartUploads:
This operation lists in-progress multipart uploads. An in-progress multipart upload is a multipart upload that has been initiated, using the InitiateMultipartUpload request, but has not yet been completed or aborted.
- (S3ListMultipartUploadsResponse *)listMultipartUploads:(S3ListMultipartUploadsRequest *)listMultipartUploadsRequest
Parameters
- listMultipartUploadsRequest
The ListMultipartUploadsRequest that defines the parameters of the operation.
Return Value
Returns a ListMultipartUploadsResponse from S3.
Discussion
This operation lists in-progress multipart uploads. An in-progress multipart upload is a multipart upload that has been initiated, using the InitiateMultipartUpload request, but has not yet been completed or aborted.
This operation returns at most 1,000 multipart uploads in the response by default. The number of multipart uploads can be further limited using the MaxUploads property on the request parameter. If there are additional multipart uploads that satisfy the list criteria, the response will contain an IsTruncated property with the value set to true. To list the additional multipart uploads use the KeyMarker and UploadIdMarker properties on the request parameters.
Declared In
AmazonS3Client.h
listObjects:
List the objects in a bucket.
- (S3ListObjectsResponse *)listObjects:(S3ListObjectsRequest *)listObjectsRequest
Parameters
- listObjectsRequest
The S3ListObjectsRequest that defines the parameters of the operation.
Return Value
An S3ListObjectsResponse from S3.
Discussion
List the objects in a bucket.
Declared In
AmazonS3Client.h
listObjectsInBucket:
List the objects in a bucket.
- (NSArray *)listObjectsInBucket:(NSString *)bucketName
Parameters
- bucketName
The name of the bucket.
Return Value
An NSArray of S3ObjectSummary objects.
Discussion
List the objects in a bucket.
Declared In
AmazonS3Client.h
listParts:
Lists the parts that have been uploaded for a particular multipart upload.
- (S3ListPartsResponse *)listParts:(S3ListPartsRequest *)listPartsRequest
Parameters
- listPartsRequest
The S3ListPartsRequest that defines the parameters of the operation.
Return Value
An S3ListPartsResponse from S3.
Discussion
Lists the parts that have been uploaded for a particular multipart upload.
This method must include the upload ID, returned by the initiateMultipartUpload request. This request returns a maximum of 1000 uploaded parts by default. You can restrict the number of parts returned by specifying the maxParts property on the listPartsRequest. If your multipart upload consists of more parts than allowed in the listParts response, the response returns a isTruncated field with value true, and a nextPartNumberMarker property. In subsequent listParts request you can include the partNumberMarker property and set its value to the nextPartNumberMarker property value from the previous response.
See Also
Declared In
AmazonS3Client.h
listVersions:
Returns a list of summary information about the versions in the specified bucket.
- (S3ListVersionsResponse *)listVersions:(S3ListVersionsRequest *)lisVersionsRequest
Discussion
Returns a list of summary information about the versions in the specified bucket.
The returned version summaries are ordered first by key and then by version. Keys are sorted lexicographically (alphabetically) while versions are sorted from most recent to least recent. Both versions with data and delete markers are included in the results.
Declared In
AmazonS3Client.h
putObject:
Upload an object to S3.
- (S3PutObjectResponse *)putObject:(S3PutObjectRequest *)putObjectRequest
Parameters
- putObjectRequest
The S3PutObjectRequest that defines the parameters of the request.
Return Value
An S3PutObjectResponse from S3.
Discussion
Upload an object to S3.
See Also
Declared In
AmazonS3Client.h
setACL:
Sets the S3AccessControlList for a given bucket or object.
- (S3SetACLResponse *)setACL:(S3SetACLRequest *)setACLRequest
Parameters
- setACLRequest
The S3SetACLRequest that defines the parameters of the operation.
Return Value
An S3SetACLResponse from S3.
Discussion
Sets the S3AccessControlList for a given bucket or object.
See Also
Declared In
AmazonS3Client.h
setBucketCrossOrigin:
Sets the CORS configuration for the specified bucket, or null if no configuration has been established. CORS config is comprised of a set of rules.
For more informaiton on how to using Bucket CORS see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/cors.html.
- (S3SetBucketCrossOriginResponse *)setBucketCrossOrigin:(S3SetBucketCrossOriginRequest *)setBucketCrossOriginRequest
Parameters
- setBucketCrossOriginRequest
request to process
Discussion
Sets the CORS configuration for the specified bucket, or null if no configuration has been established. CORS config is comprised of a set of rules.
For more informaiton on how to using Bucket CORS see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/cors.html.
Exceptions
- AmazonClientException
If any errors are encountered on the client while making the request or handling the response. For more information see AmazonClientException.
- AmazonServiceException
If any errors occurred in Amazon S3 while processing the request. For more information see AmazonServiceException.
Declared In
AmazonS3Client.h
setBucketLifecycleConfiguration:
Sets the lifecycle configuration for the specified bucket. Bucket lifecycle configuration allows you specify a number of rules for object based on the object’s key prefix. Each rule is a combination of id, prefix status and expiration time (in days).
For more informaiton on how to use Bucket Lifecycle/Object Expiration see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/ObjectExpiration.html.
- (S3SetBucketLifecycleConfigurationResponse *)setBucketLifecycleConfiguration:(S3SetBucketLifecycleConfigurationRequest *)setBucketLifecycleConfigurationRequest
Parameters
- setBucketLifecycleConfigurationRequest
The request to process
Discussion
Sets the lifecycle configuration for the specified bucket. Bucket lifecycle configuration allows you specify a number of rules for object based on the object’s key prefix. Each rule is a combination of id, prefix status and expiration time (in days).
For more informaiton on how to use Bucket Lifecycle/Object Expiration see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/ObjectExpiration.html.
Exceptions
- AmazonClientException
If any errors are encountered on the client while making the request or handling the response. For more information see AmazonClientException.
- AmazonServiceException
If any errors occurred in Amazon S3 while processing the request. For more information see AmazonServiceException.
Declared In
AmazonS3Client.h
setBucketPolicy:
Sets the policy associated with the specified bucket. Only the owner of the bucket can set a bucket policy. If a policy already exists for the specified bucket, the new policy replaces the existing policy.
- (S3SetBucketPolicyResponse *)setBucketPolicy:(S3SetBucketPolicyRequest *)setPolicyRequest
Discussion
Sets the policy associated with the specified bucket. Only the owner of the bucket can set a bucket policy. If a policy already exists for the specified bucket, the new policy replaces the existing policy.
Bucket policies provide access control management at the bucket level for both the bucket resource and contained object resources. Only one policy can be specified per-bucket.
Declared In
AmazonS3Client.h
setBucketTagging:
Sets the tagging configuration for the specified bucket. A tagging configuration contains a TagSet.
For more informaiton on how to using Bucket Cost Allocation Tagging see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/BucketBilling.html.
- (S3SetBucketTaggingResponse *)setBucketTagging:(S3SetBucketTaggingRequest *)setBucketTaggingRequest
Parameters
- setBucketTaggingRequest
request to process
Discussion
Sets the tagging configuration for the specified bucket. A tagging configuration contains a TagSet.
For more informaiton on how to using Bucket Cost Allocation Tagging see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/BucketBilling.html.
Exceptions
- AmazonClientException
If any errors are encountered on the client while making the request or handling the response. For more information see AmazonClientException.
- AmazonServiceException
If any errors occurred in Amazon S3 while processing the request. For more information see AmazonServiceException.
Declared In
AmazonS3Client.h
setBucketVersioningConfiguration:
Sets the versioning configuration for the specified bucket. A bucket’s versioning configuration can be in one of three possible states: Off, Enabled, or Suspended
- (S3SetBucketVersioningConfigurationResponse *)setBucketVersioningConfiguration:(S3SetBucketVersioningConfigurationRequest *)setBucketVersioningConfigurationRequest
Discussion
Sets the versioning configuration for the specified bucket. A bucket’s versioning configuration can be in one of three possible states: Off, Enabled, or Suspended
By default, new buckets are in the Off state. Once versioning is enabled for a bucket the status can never be reverted to Off.
Objects created before versioning was enabled or when versioning is
suspended will be given the default null
version ID. Note
that the null
version ID is a valid version ID and is not
the same as not having a version ID.
The versioning configuration of a bucket has different implications for
each operation performed on that bucket or for objects within that
bucket. For example, when versioning is enabled a PutObject
operation creates a unique object version-id for the object being uploaded. The
The PutObject
API guarantees that, if versioning is enabled for a bucket at
the time of the request, the new object can only be permanently deleted
using a DeleteVersion
operation. It can never be overwritten.
Additionally, the PutObject
API guarantees that,
if versioning is enabled for a bucket the request,
no other object will be overwritten by that request.
Refer to the documentation sections for each API for information on how
versioning status affects the semantics of that particular API.
Declared In
AmazonS3Client.h
setBucketWebsiteConfiguration:
Sets the website configuration for the specified bucket. Bucket website configuration allows you to host your static websites entirely out of Amazon S3. To host your website in Amazon S3, create a bucket, upload your files, and configure it as a website. Once your bucket has been configured as a website, you can access all your content via the Amazon S3 website endpoint. To ensure that the existing Amazon S3 REST API will continue to behave the same, regardless of whether or not your bucket has been configured to host a website, a new HTTP endpoint has been introduced where you can access your content. The bucket content you want to make available via the website must be publicly readable.
For more information on how to host a website on Amazon S3, see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/WebsiteHosting.html.
This operation requires the S3:PutBucketWebsite
permission.
By default, only the bucket owner can configure the website attached to a
bucket. However, bucket owners can allow other users to set the website
configuration by writing a bucket policy granting them the
S3:PutBucketWebsite
permission.
- (S3SetBucketWebsiteConfigurationResponse *)setBucketWebsiteConfiguration:(S3SetBucketWebsiteConfigurationRequest *)setBucketWebsiteConfigurationRequest
Parameters
- bucketName
The name of the bucket whose website configuration is being set.
- configuration
The configuration describing how the specified bucket will serve web requests (i.e. default index page, error page).
Discussion
Sets the website configuration for the specified bucket. Bucket website configuration allows you to host your static websites entirely out of Amazon S3. To host your website in Amazon S3, create a bucket, upload your files, and configure it as a website. Once your bucket has been configured as a website, you can access all your content via the Amazon S3 website endpoint. To ensure that the existing Amazon S3 REST API will continue to behave the same, regardless of whether or not your bucket has been configured to host a website, a new HTTP endpoint has been introduced where you can access your content. The bucket content you want to make available via the website must be publicly readable.
For more information on how to host a website on Amazon S3, see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/WebsiteHosting.html.
This operation requires the S3:PutBucketWebsite
permission.
By default, only the bucket owner can configure the website attached to a
bucket. However, bucket owners can allow other users to set the website
configuration by writing a bucket policy granting them the
S3:PutBucketWebsite
permission.
Exceptions
- AmazonClientException
If any errors are encountered on the client while making the request or handling the response. For more information see AmazonClientException.
- AmazonServiceException
If any errors occurred in Amazon S3 while processing the request. For more information see AmazonServiceException.
Declared In
AmazonS3Client.h
uploadPart:
Uploads a part in a multipart upload. You must initiate a multipart upload before you can upload any part.
- (S3UploadPartResponse *)uploadPart:(S3UploadPartRequest *)uploadPartRequest
Parameters
- uploadPartRequest
The S3UploadPartRequest that defines the parameters of the operation.
Return Value
An S3UploadPartResponse from S3.
Discussion
Uploads a part in a multipart upload. You must initiate a multipart upload before you can upload any part.
Your uploadPart request must include an upload ID and a part number. The upload ID is the ID returned by Amazon S3 in response to your Initiate Multipart Upload request. Part number can be any number between 1 and 10,000, inclusive. A part number uniquely identifies a part and also defines its position within the object being uploaded. If you upload a new part using the same part number that was specified in uploading a previous part, the previously uploaded part is overwritten.
When you upload a part, the S3UploadPartResponse response contains an etag property. You should record this etag property value and the part number. After uploading all parts, you must send a completeMultipartUpload request. At that time Amazon S3 constructs a complete object by concatenating all the parts you uploaded, in ascending order based on the part numbers. The completeMultipartUpload request requires you to send all the part numbers and the corresponding etag values.
See Also
Declared In
AmazonS3Client.h


public abstract class JsonValue extends Object implements Serializable
The literals true, false, and null are represented by the
constants TRUE
, FALSE
, and NULL
.
JSON objects and arrays are represented by the subtypes JsonObject
and
JsonArray
. Instances of these types can be created using the public constructors of these classes.
Instances that represent JSON numbers, strings and boolean values
can be created using the static factory methods valueOf(String)
, valueOf(long)
,
valueOf(double)
, etc.
In order to find out whether an instance of this class is of a certain type, the methods isObject()
,
isArray()
, isString()
, isNumber()
etc. can be used.
If the type of a JSON value is known, the methods asObject()
, asArray()
, asString()
,
asInt()
, etc. can be used to get this value directly in the appropriate target type.
This class is not supposed to be extended by clients.
| Modifier and Type | Field and Description |
|---|---|
static JsonValue |
FALSE
Deprecated.
Use
Json.FALSE instead |
static JsonValue |
NULL
Deprecated.
Use
Json.NULL instead |
static JsonValue |
TRUE
Deprecated.
Use
Json.TRUE instead |
| Modifier and Type | Method and Description |
|---|---|
JsonArray |
asArray()
Returns this JSON value as
JsonArray , assuming that this value represents a JSON array. |
boolean |
asBoolean()
Returns this JSON value as a
boolean value, assuming that this value is either true or
false . |
double |
asDouble()
Returns this JSON value as a
double value, assuming that this value represents a JSON number. |
float |
asFloat()
Returns this JSON value as a
float value, assuming that this value represents a JSON number. |
int |
asInt()
Returns this JSON value as an
int value, assuming that this value represents a JSON number that can be
interpreted as Java int . |
long |
asLong()
Returns this JSON value as a
long value, assuming that this value represents a JSON number that can be
interpreted as Java long . |
JsonObject |
asObject()
Returns this JSON value as
JsonObject , assuming that this value represents a JSON object. |
String |
asString()
Returns this JSON value as String, assuming that this value represents a JSON string.
|
boolean |
equals(Object object)
Indicates whether some other object is "equal to" this one according to the contract specified in
Object.equals(Object) . |
int |
hashCode() |
boolean |
isArray()
Detects whether this value represents a JSON array.
|
boolean |
isBoolean()
Detects whether this value represents a boolean value.
|
boolean |
isFalse()
Detects whether this value represents the JSON literal
false . |
boolean |
isNull()
Detects whether this value represents the JSON literal
null . |
boolean |
isNumber()
Detects whether this value represents a JSON number.
|
boolean |
isObject()
Detects whether this value represents a JSON object.
|
boolean |
isString()
Detects whether this value represents a JSON string.
|
boolean |
isTrue()
Detects whether this value represents the JSON literal
true . |
static JsonValue |
readFrom(Reader reader)
Deprecated.
Use
Json.parse(Reader) instead |
static JsonValue |
readFrom(String text)
Deprecated.
Use
Json.parse(String) instead |
String |
toString()
Returns the JSON string for this value in its minimal form, without any additional whitespace.
|
String |
toString(WriterConfig config)
Returns the JSON string for this value using the given formatting.
|
static JsonValue |
valueOf(boolean value)
Deprecated.
Use
Json.value() instead |
static JsonValue |
valueOf(double value)
Deprecated.
Use
Json.value() instead |
static JsonValue |
valueOf(float value)
Deprecated.
Use
Json.value() instead |
static JsonValue |
valueOf(int value)
Deprecated.
Use
Json.value() instead |
static JsonValue |
valueOf(long value)
Deprecated.
Use
Json.value() instead |
static JsonValue |
valueOf(String string)
Deprecated.
Use
Json.value() instead |
void |
writeTo(Writer writer)
Writes the JSON representation of this value to the given writer in its minimal form, without any additional
whitespace.
|
void |
writeTo(Writer writer,
WriterConfig config)
Writes the JSON representation of this value to the given writer using the given formatting.
|
@Deprecated public static final JsonValue TRUE
Json.TRUE
insteadtrue
.@Deprecated public static final JsonValue FALSE
Json.FALSE
insteadfalse
.@Deprecated public static final JsonValue NULL
Json.NULL
insteadnull
.@Deprecated public static JsonValue readFrom(Reader reader) throws IOException
Json.parse(Reader)
instead
Characters are read in chunks and buffered internally, therefore wrapping an existing reader in an additional
BufferedReader
does not improve reading performance.
reader
- the reader to read the JSON value fromIOException
- if an I/O error occurs in the readerParseException
- if the input is not valid JSON@Deprecated public static JsonValue readFrom(String text)
Json.parse(String)
insteadtext
- the string that contains the JSON valueParseException
- if the input is not valid JSON@Deprecated public static JsonValue valueOf(int value)
Json.value()
insteadint
value.value
- the value to get a JSON representation for@Deprecated public static JsonValue valueOf(long value)
Json.value()
insteadlong
value.value
- the value to get a JSON representation for@Deprecated public static JsonValue valueOf(float value)
Json.value()
insteadfloat
value.value
- the value to get a JSON representation for@Deprecated public static JsonValue valueOf(double value)
Json.value()
insteaddouble
value.value
- the value to get a JSON representation for@Deprecated public static JsonValue valueOf(String string)
Json.value()
insteadstring
- the string to get a JSON representation for@Deprecated public static JsonValue valueOf(boolean value)
Json.value()
insteadboolean
value.value
- the value to get a JSON representation forpublic boolean isObject()
JsonObject
.true
if this value is an instance of JsonObjectpublic boolean isArray()
JsonArray
.true
if this value is an instance of JsonArraypublic boolean isNumber()
true
if this value represents a JSON numberpublic boolean isString()
true
if this value represents a JSON stringpublic boolean isBoolean()
true
if this value represents either the JSON literal true
or false
public boolean isTrue()
true
.true
if this value represents the JSON literal true
public boolean isFalse()
false
.true
if this value represents the JSON literal false
public boolean isNull()
null
.true
if this value represents the JSON literal null
public JsonObject asObject()
JsonObject
, assuming that this value represents a JSON object. If this is not
the case, an exception is thrown.UnsupportedOperationException
- if this value is not a JSON objectpublic JsonArray asArray()
JsonArray
, assuming that this value represents a JSON array. If this is not the
case, an exception is thrown.UnsupportedOperationException
- if this value is not a JSON arraypublic int asInt()
int
value, assuming that this value represents a JSON number that can be
interpreted as Java int
. If this is not the case, an exception is thrown.
To be interpreted as Java int
, the JSON number must neither contain an exponent nor a fraction part.
Moreover, the number must be in the Integer
range.
int
UnsupportedOperationException
- if this value is not a JSON numberNumberFormatException
- if this JSON number can not be interpreted as int
valuepublic long asLong()
long
value, assuming that this value represents a JSON number that can be
interpreted as Java long
. If this is not the case, an exception is thrown.
To be interpreted as Java long
, the JSON number must neither contain an exponent nor a fraction part.
Moreover, the number must be in the Long
range.
long
UnsupportedOperationException
- if this value is not a JSON numberNumberFormatException
- if this JSON number can not be interpreted as long
valuepublic float asFloat()
float
value, assuming that this value represents a JSON number. If this
is not the case, an exception is thrown.
If the JSON number is out of the Float
range, Float.POSITIVE_INFINITY
or
Float.NEGATIVE_INFINITY
is returned.
float
UnsupportedOperationException
- if this value is not a JSON numberpublic double asDouble()
double
value, assuming that this value represents a JSON number. If this
is not the case, an exception is thrown.
If the JSON number is out of the Double
range, Double.POSITIVE_INFINITY
or
Double.NEGATIVE_INFINITY
is returned.
double
UnsupportedOperationException
- if this value is not a JSON numberpublic String asString()
UnsupportedOperationException
- if this value is not a JSON stringpublic boolean asBoolean()
boolean
value, assuming that this value is either true
or
false
. If this is not the case, an exception is thrown.boolean
UnsupportedOperationException
- if this value is neither true
or false
public void writeTo(Writer writer) throws IOException
Writing performance can be improved by using a BufferedWriter
.
writer
- the writer to write this value toIOException
- if an I/O error occurs in the writerpublic void writeTo(Writer writer, WriterConfig config) throws IOException
Writing performance can be improved by using a BufferedWriter
.
writer
- the writer to write this value toconfig
- a configuration that controls the formatting or null
for the minimal formIOException
- if an I/O error occurs in the writerpublic String toString()
readFrom(String)
and to create a value that is
equal to this object.public String toString(WriterConfig config)
config
- a configuration that controls the formatting or null
for the minimal formpublic boolean equals(Object object)
Object.equals(Object)
.
Two JsonValues are considered equal if and only if they represent the same JSON text. As a consequence, two given JsonObjects may be different even though they contain the same set of names with the same values, but in a different order.
RestFB 2.0.0-rc.2. Copyright © 2010-2015 Mark Allen. All Rights Reserved.


Writers Erin Kelly, James Runcie, Alison Bruce, James Henry, Elly Griffiths, and Nicci French are all coming to Suffolk for this year’s Bookfest
It’s said that everyone has a novel in them. Why not coax yours out at our ‘How to write a thriller’ session at Stradbroke Library on Monday 24 October, as part of Bookfest? Author Erin Kelly, who has published five thrillers, including the novelisation of the hugely successful ITV drama Broadchurch, will be offering advice on how to create compelling characters and settings, a tight plot and structure, and twists and turns that will make your readers gasp. She will also be signing books.
While you’re writing your novel, what music might get you in the mood to write, or feature in your story? Alison Bruce, author of the DC Gary Goodhew series of murder mysteries set in Cambridge, will be appearing at Brandon Library on Thursday 27 October with her husband Jacen to discuss and play some of the music that underpins her novels. They will also talk about their experiences of living and working together as two creative individuals. Bruce will also talk about the classic British crime novels, American pulp fiction, black and white movies, and TV crime that have inspired her work, and will be signing books.
James Runcie, creator of the Grantchester book and television series, will be appearing not just once, but twice at Bookfest. He will be in Southwold on Wednesday 26 October, talking to writer and broadcaster Paul Heiney about the particular challenges and rewards of writing for television. On Thursday 27 October, he will be in Lavenham discussing the Grantchester novels. The Friends of Lavenham Library will provide tea and homemade cake. Both talks promise fascinating insights and entertainment, as Runcie is a skilled orator. Fans can get their books signed at either event.
Elly Griffiths, another acclaimed mystery-writer, will be launching her new novel at a special event at Felixstowe Library on Saturday 29 October. Griffiths’ Stephens and Mephisto novels centre around magicians performing on the south coast in the 1950s, and the secrets, lies, and crimes that surround them. To launch the third novel in the series, The Blood Card, the library is adopting a ’50s theme and enlisting local magician Mr. Bean to entertain and confound guests with his intriguing tricks and sleights of hand as they arrive, and during the book signing at the end of the evening.
Thriller-lovers will no doubt have heard of James Henry, who has written a series of prequels to RD Wingfield’s DI Frost novels. At Leiston Library on Friday 28 October, he will be discussing his latest novel, Blackwater, the first book in a new series set just down the road around the Essex coast and estuary, featuring smugglers, dealers and the criminal underworld. A book signing will follow the discussion.
Another big name in the thriller world is Nicci French: husband-and-wife team Nicci Gerrard and Sean French, who will be speaking at Brandon Library on Sunday 30 October. They have published 20 bestselling novels together. Their latest offering, Saturday Requiem is the sixth book in their popular Frieda Klein series. The couple will discuss their long success writing psychological thrillers, the rising popularity of the genre, particularly among women, and how they work together to co-author novels at their Suffolk home. Be sure to bring your favourite Nicci French novel for signing.
How to write a thriller, with Erin Kelly at Stradbroke Library - Monday 24 October, 7:30pm, £6. Refreshments will be available, and there will be a book signing at 8:30pm. Buy tickets.
Murder, marriage and music with Alison Bruce at Brandon Library - Thursday 27 October, 7:30pm, £6. Book signing at 8:30pm. Buy tickets.
James Runcie on writing for TV, with Paul Heiney at St Edmund's Hall, Southwold - Wednesday 26 October, 3pm, £6. Book signing at 4pm. Buy tickets.
Taking tea in the library with James Runcie at Lavenham Village Hall - Thursday 27 October, 3pm, £8. Tea and homemade cake will be provided, book signing at 4:30pm. Buy tickets.
Magic and Mystery with Elly Griffiths at Felixstowe Library - Saturday 29 October, 7pm, £8. Author's talk begins at 7:30pm, cash bar, book signing after the talk. Buy tickets.
Meet the author: James Henry at Leiston Library - Friday 28 October, 7:30pm, £6. Book signing at 8:30pm. Buy tickets.
Nicci French at Brandon Library - Sunday 30 October, 7:30pm, £6. Book signing at 8:30pm. Buy tickets.
</div>


Sender address for bounce mail
double_bounce_sender
This parameter specifies the sender address for mail that must be discarded
when it cannot be delivered. This must be a unique name. All mail to this name
is silently discarded, in order to terminate mail bounce loops.


(Baltimore American, October 15, 1894)
The Lyceum Theater was crowded last night at the first of a series of meetings by the Vrooman Brothers. The subject discussed was "Dynamic Religion".
Swami Vivekananda, the high priest [?] from India, was the last speaker. He spoke briefly, and was listened to with marked attention. His English and his mode of delivery were excellent. There is a foreign accent to his syllables, but not enough to prevent him from being plainly understood. He was dressed in the costume of his native country, which was decidedly picturesque. He said he could speak but briefly after the oratory that had preceded him, but he could add his endorsement to all that had been said. He had traveled a great deal, and preached to all kinds of people. He had found that the particular kind of doctrine preached made little difference. What is wanted is practical sort of work. If such ideas could not be carried out, he would lose his faith in humanity. The cry all over the world is "less doctrine and more bread". He thought the sending of missionaries to India all right; he had no objections to offer, but he thought it would be better to send fewer men and more money. So far as India was concerned, she had religious doctrine to spare. Living up to the doctrines was needed more than more doctrines. The people of India, as well as the people all over the world, had been taught to pray, but prayer with the lips was not enough; people should pray with their hearts. "A few people in the world," he said, "really try to do good. Others look on and applaud, and think that they themselves have done great good. Life is love, and when a man ceases to do good to others, he is dead spiritually."
On Sunday evening next Swami Vivekananda will make the address of the evening at the Lyceum.
(Sun, October 15, 1894)
Vivekananda sat on the stage last night with imperturbable stolidity until it came his turn to speak. Then his manner changed and he spoke with force and feeling. He followed the Vrooman brothers and said there was little to add to what had been said save his testimony as a "man from the Antipodes".
"We have doctrines enough," he continued. "What we want now is practical work as presented in these speeches. When asked about the missionaries sent to India I reply all right. But we want money more and men less. India has bushels full of doctrines and to spare. What is wanted is the means to carry them out.
"Prayer may be done in different ways. Prayer with the hands is yet higher than prayer with the lips and is more saving.
"All religions teach us to do good for our brothers. Doing good is nothing extraordinary — it is the only way to live. Everything in nature tends to expansion for life and contraction for death. It is the same in religion. Do good by helping others without ulterior motives. The moment this ceases contraction and death follow."


Portfolio
Helping you to capture your precious moments and making memories out of it.
About
Hi, we are Asjad and Aroob! A husband and wife photographer couple. We truly believe in the union of two hearts. Marriage and love, capturing the magical moments between two lovers. Working with different people and cultures makes us happy. Our moto is to build a friendly relationship so that we can enjoy your lucky day together.
Asjad Azeem
I have always been interested in capturing emotions, may it be in any form. Weddings bring more joy to me personally because everyone is so happy! I enjoy landscape and street photography as well.
Aroob Anwer
I personally feel theres a lot happening during wedding days and nervousness is obvious. My key thing is to lighten up the mood and let the conversation started. I truly believe that when we become friends from just being photographer, everyone opens up.
Contact
Let's talk about your story now
Every story is unique in its own way. What makes your story significant than others?


[
prev
] [
prev-tail
] [
tail
] [
up
]
5.10
3D trajectory of guiding-center
Figure 26:
Three-dimensional illustration of the guidieng-center orbit of a trapped particle in a tokamak.
[
prev
] [
prev-tail
] [
front
] [
up
]


Created by K.ArunGanessh / K.dinesh
* Relatively nascent field in comparison
* Machines are getting faster or more
powerful
* Are we getting better in delivering
software applications though
* Less than 10% of software projects
meet failures in Agile Technology
* Criteria for success?: On time, within
budget, feature complete, works (failure
free)
Concave -
Zoom
* Waterfall approach4
- Actually specified iteration - largely ignored
* Customer's mind is not frozen after they
give us the requirements
* The Customer tells how should be the project
* How the project manager understood it
* How the analyst designed it.
* How the programmmer made it.
* How the Consultant described it.
* What operation was installed.
* How much was cost
* How it was supported
* Atlast how it was delivered to customer
*In Traditional Feature is only fixed & Quality,Cost,Time can be changed
| XP | SCRUM | EVO | |
|---|---|---|---|
| ITERATION | 2/3weeks | 30days | 5days |
| Customer Participation | strong | strong | Very Strong |
| Business Process | Medium | High | Too High |
- Too little, does not solve problems
- Too much, some times more of a problem
- More time can improve quality and increase scope.
- Too much time hurts as well
- Sacrificing this may result in short term gains
- Over the long haul, lost is enormous


<IP_ADDRESS> (August 29, 2019) - Writes a project information file - Fixed the option to ignore storage when transfer a configuration


This demo consists of 43930 vertices, 48888 faces and 3 textures. It may take several minutes to load.
The iphone 4 model used in this demo is from the internet. It should not be used for any commercial purpose.


Cameron MacCabe
About
|
Portfolio
|
Contact
Portfolio
Moodie
Train Scheduler
Word Guess Game
SpongeMeme SquareGIFs
Trivia Game
Crystal Collector Game
Psychic Game


module App:sig
..end
val env : string -> default:'a -> (string -> 'a) -> 'a
env var ~default parse
lookups var
in the environment, parses
it with parse
and returns the result. If parse
raises or
if var
is not in the environment default
is returned.
Data lookup depends on the backend:
`Tsdl
uses Sys.getenv
.`Jsoo
lookups the query string of window.location
for the first matching var=value
pair.val prefs_path : org:string -> app:string -> [ `Error of string | `Ok of string ]
TODO
this should used the app name automatically.
Unique to user and app.val quit : unit React.event
quit
occurs whenever the user requested to quit. The meaning
depends on the backend:
`Tsdl
, this is only a hint, e.g. the last window
was closed or a platform dependent way of quitting
applications was invoked`Jsoo
, the browser window is closing and it's your
last chance to peform somethingval init : ?name:string ->
?surface:Useri.Surface.t -> unit -> [ `Error of string | `Ok of unit ]
init name surface
initialises an application named name
(default
derived from the executable name) with surface surface
(defaults
to a default Useri.Surface.create
.)val run_step : unit -> Useri.Time.span
run_step ()
gather as much user input as possible and returns
the maximal timespan after which Useri.App.run_step
should be called again.val run : ?until:'a React.event -> unit -> unit
run until
depends on the backend scheme:
`Sync
invokes Useri.App.run_step
repeatedly and blocks until
the first occurence of until
(defaults to Useri.App.quit
).
After Useri.App.run
returned it can be called again.`Async
returns immediately, until
is irrelevant.val release : ?sinks:bool -> unit -> unit
release sinks ()
does the following:
Useri.App.stop
event occur.sinks
is true
(default), calls Useri.App.release_sinks
.
After a Useri.App.release
it should be possible to Useri.App.init
again.
val start : unit React.event
val stop : unit React.event
val sink_event : 'a React.event -> unit
sink_event e
keeps a reference on e
until the app exit
s.val sink_signal : 'a React.signal -> unit
sink_signal s
keeps a reference on s
until the app exit
s.val release_sinks : unit -> unit
typelaunch_context =
[ `Browser | `Gui | `Terminal ]
val launch_context : launch_context
launch_context
is the mechanism that started the program.val pp_launch_context : Format.formatter -> launch_context -> unit
pp_launch_context ppf c
prints an unspecified representation of
c
on ppf
.val platform : string
platform
is the name of the platform you are running on.
Warning. Do not expect different backend to report the same
platform with the same string.
typebackend =
[ `Jsoo | `Other of string | `Tsdl ]
Useri
's backends.val backend : backend
backend
is Useri
's current backend.val pp_backend : Format.formatter -> backend -> unit
pp_backend ppf b
prints an unspecified representation of
c
on ppf
.val set_backend_logger : ([ `Error | `Warning ] -> string -> unit) -> unit
set_backend_logger log
sets log
to be called by backends
whenever non-fatal internal warnings and errors are generated.
The default function outputs and flushes to stderr.typebackend_scheme =
[ `Async | `Sync ]
`Sync
, the backend is synchronous the client of the library
is in charge of running the event loop by using Useri.App.run_step
or Useri.App.run
.`Async
, the backend is asynchronous, there's an inversion
of control, the call to Useri.App.run
won't block.val backend_scheme : [ `Async | `Sync ]
backend_scheme
is the Useri
's current backend's scheme.val pp_backend_scheme : Format.formatter -> backend_scheme -> unit
pp_backend_scheme ppf bs
prints and unspecified representation of
bs
on ppf
.typecpu_count =
[ `Known of int | `Unknown ]
val cpu_count : cpu_count
cpu_count
is the number of CPU available.val pp_cpu_count : Format.formatter -> cpu_count -> unit
pp_cpu_count ppf c
prints an unspecified representation of c
on ppf
.


--- layout: archive title: Zulip Chat Archive permalink: /stream/113488-general/topic/Open_locale.html ---
I'm away from a computer right now so am browsing PRs on my phone. I just saw an open_locale matrix
. I've only ever opened classical
. Where can I read about what other locales can be opened?
I don't think there's a list in the docs (yet), but when you get back to a computer you can put the following in a file to get a list of all imported locales:
run_cmd do m ← localized_attr.get_cache, tactic.trace m.keys -- change to `tactic.trace m.to_list` -- to list all the commands in each namespace
I put this in #1874, but that's currently stalled since I haven't been able to reproduce how the current mathlib docs are created.
You can also grep sources for the word localized
You can also see which commands are executed when writing open_locale matrix
by executing
run_cmd print_localized_commands [`matrix]
Last updated: Apr 24 2020 at 19:02 UTC


Change Password of {{ user }}
Change Password
Old Password
New Password
Confirm Password
Go Back
Submit


WCF Behavior
Common Tweaks
The maximum message size quota for incoming messages (65536) has been exceeded.
- increase maxReceivedMessageSize!
Throttling: maxConcurrentCalls.
InstanceContextMode
PerCall is default (NB: goes on implementation, not interface)
[ServiceBehavior(InstanceContextMode = InstanceContextMode.PerCall)]
public class Service1 : IService
Sessions
If you use sessions, the contract must state for the client
[ServiceContract(SessionMode = SessionMode.Required)]
public interface IService
And then implement it
[ServiceBehavior(InstanceContextMode = InstanceContextMode.PerSession)]
public class Service1 : IService
If the client tries to use an open session after it expired, it gets a CommunicationObjectFaultedException. The default is 10 minutes - see ReliableSession.InactivityTimeout and Binding.ReceiveTimeout (you can set "infinite" but IIS will recycle you anyway). basicHttpBinding does not support sessions.
[OperationContract(IsInitiating = false, IsTerminating = true)]
Response Final(int number);
- IsInitiating
- (Default true)- create a session or use existing.
If set to false, cannot open a session. - IsTerminating
- (Default false)- close a session (still need the proxy to Close)
Singleton
[ServiceBehavior(InstanceContextMode = InstanceContextMode.Single)]
public class Service1 : IService
It supports clients who uses sessions, but obviously everything must be thread-safe. You can create a self-hosted service passing in the singleton into the constructor.
Instance Behaviors
[OperationBehavior(ReleaseInstanceMode =
ReleaseInstanceMode.BeforeAndAfterCall)]
public void UpdateResource()
- BeforeCall
- creates new instance (disposes any existing instance)
- AfterCall
- disposed when finished
- BerforeAndAfterCall
- InstanceContextMode.PerCall (for one method while the others have sessions)
Concurrency
You can queue requests with Single concurrency (or Multiple to handle simultaneous calls)
[ServiceBehavior(ConcurrencyMode = ConcurrencyMode.Single)]
public class Service1 : IService
Reentrant is locked like Single, but can release locks which processing (inner WCF calls)
Duplex messaging
Because it does a callback, these must be ConcurrencyMode = ConcurrencyMode.Multiple or Reentrant (not single).
Transactions
See also contracts where you can specify [TransactionFlow(TransactionFlowOption.Mandatory)]
//requires transaction and will commit when finished
[OperationBehavior(TransactionScopeRequired = true)]
public void DoWork()
MSMQ transactions can't span both ends of the queue, but you can do batch transactions by adding an endpointBehavior with <transactedBatching maxBatchSize="100"/>.
On the service implementation add [ServiceBehavior(ReleaseServiceInstanceOnTransactionComplete = false)] so the instance keeps alive through the batch
Anonymous Behavior
In .Net 4.0+, you don't need a <service> configuration with endpoints at all- it can autogenerate for your contracts and schema (default for http is basicHttpBinding). Change the mappings (http default with <protocolMapping><add scheme="http" binding="wsHttpBinding" bindingConfiguration="MyBindingConfiguration"/>
Unnamed behavior elements (or name="") refer to the current service.
WCF Runtime Extensibility
You add an IEndpointBehavior which implements ApplyClient/ApplyDispatchBahvior or ApplyBindingParameters:
endpoint.Behaviors.Add(myIEndpointBehavior)
public class LoggingEndpointBehavior : IEndpointBehavior
{
public void AddBindingParameters(ServiceEndpoint endpoint,
BindingParameterCollection bindingParameters)
{ }
public void ApplyClientBehavior(ServiceEndpoint endpoint, ClientRuntime clientRuntime)
{
//implements IClientMessageInspector
var inspector = new MessageLogInspector();
clientRuntime.MessageInspectors.Add(inspector);
}
public void ApplyDispatchBehavior(ServiceEndpoint endpoint, EndpointDispatcher endpointDispatcher)
{
//implements IDispatchMessageInspector
var inspector = new MessageLogInspector();
endpointDispatcher.DispatchRuntime.MessageInspectors.Add(inspector);
}
public void Validate(ServiceEndpoint endpoint)
{ }
}
- IParameterInspector (BeforeCall/ AfterCall):
- Server: add in IEndpointBehavior.ApplyDispatchBehavior
- Client: add in IEndpointBehavior.ApplyClientBehavior
- MessageInspectors-
on client, IClientMessageInspector (BeforeSendRequest, AfterReceiveReply),
on service, IDispatchClientInspector (AfterReceiveRequest, BeforeSendReply).
A serialized message body is a stream, so can be read only once (by ToString() or GetBody<T>())- so use a buffered copy
var buffer = request.CreateBufferedCopy(Int32.MaxValue)
var x = buffer.CreateMessage().GetBody<T>()
To modify it through a configuration file (in extensions/behaviorExtensions- the name can then be an element under endpointBehaviors/behavior/), derive from BehaviorExtensionElement (CreateBehavior())


Outlook E-mail
GoToMeeting conferences
MyHub
Resident's Corner
Schedules
Phone
Directory
Paging Directory
Network shares
iRadiology Lite
IDAS Report Portal
Resident
Call Coverage
IR
call chart
Moonlighting
Rules (old)
*Use CONNECT@UPMC off-campus
Request for leave form
Moonlighting tele form
Overnight Contact #'s
Tech paging chart
Helpful #'s for SHY
call
Introduction to Radiology
What
makes a great resident?
Needs updated for AIRP
{# Great AFIP Cases#}


Holy Ark of Secrecy 1:
This ark seems to be locked. Breaking it may damage its contents. You will need to find a key to open it.


What to eat?
How hungry are you?
😐
😣
😫
🤬
Feed me plz
Eat this:
Click to find it near you!
With this:
Drink pairing:
Dessert:


public interface MultiCall<T,R>
extends java.lang.Cloneable
The request can be executed in a number of ways
MultiCallback
| Modifier and Type | Method and Description |
|---|---|
void |
cancel()
Cancels all the requests in this MultiCall
|
MultiCall<T,R> |
clone()
Creates a new instance of a MultiCall object to be reused for the same calls
|
void |
enqueue(MultiCallback<T,R> callback)
Enqueues asynchronously and calls a MultiCallback to notify progress, completion or failure
|
java.util.List<R> |
enqueueAndWait()
Enqueues on another thread but blocks the calling thread until completion or until an exception is thrown
|
java.util.List<R> |
enqueueAndWait(long timeout,
java.util.concurrent.TimeUnit timeUnit)
Enqueues on another thread but blocks the calling thread for
at most the amount of time specified in the arguments.
|
java.util.List<R> |
execute()
Executes synchronously and blocks until completion or until an exception is thrown
|
boolean |
isCancelled()
Returns true if this MultiCall has been
cancelled, false otherwise
|
boolean |
isExecuted()
Returns true if this MultiCall has
been executed already
|
java.lang.String |
methodName()
The API method name to be executed.
|
java.util.List<T> |
requests()
Returns a List of the requests for this MultiCall
|
Interactor<R>
|
start()
Start executing the call and return a Interactor
|
java.lang.String methodName()
java.util.List<T> requests()
java.util.List<R> execute() throws java.io.IOException
java.io.IOException
- on failed IO operationsjava.util.List<R> enqueueAndWait() throws java.io.IOException, java.lang.InterruptedException
java.io.IOException
- on failed network operationsjava.lang.InterruptedException
- if the calling thread is interruptedjava.util.List<R> enqueueAndWait(long timeout, java.util.concurrent.TimeUnit timeUnit) throws java.io.IOException, java.lang.InterruptedException, java.util.concurrent.TimeoutException
Note you are not guaranteed to receive all the responses in the time you specified and if all the operations are not complete in this time a TimeoutException will be thrown
timeout
- The maximum amount of time before an attempt to collect the results from this operationtimeUnit
- The unit in which you specified the time argumentjava.io.IOException
- on failed IO operationsjava.lang.InterruptedException
- if the waiting thread was interruptedjava.util.concurrent.TimeoutException
- if the time is up before all the responses have been receivedvoid enqueue(MultiCallback<T,R> callback)
callback
- The MultiCallback to be fired on success or failureInteractor<R> start()
For more details on usage, see Interactor
boolean isExecuted()
void cancel()
boolean isCancelled()


{%- include head.html -%}
The Hurricane Group is comprised of four companies with over 120 years of combined experience: Hurricane Hydrovac, Hurricane SMS, Heaton Sanitation, and Ken Lapain and Sons Ltd. All of these companies were built on the foundation of core family principles and values. These same principles continue to be the guiding light for all four companies, combined with an overarching focus on integrity, professionalism, and quality workmanship
Our leadership team is diverse, although all members have backgrounds in construction, their experience in the industry is vast. Each brings forward many years of experience, knowledge and various skill sets, which allows our group of companies to deliver quality services consistently time after time.
Shawn O'Keefe is responsible for overseeing the group of companies. Shawn graduated from the University of Windsor with a civil engineering degree. After graduation Shawn become President and shareholder of Michael O'Keefe Ltd. Shawn has over 25 years' experience in the civil construction industry. While Shawn's primary focus was excavation, his background, reputation and in-depth knowledge of technology has allowed him to successfully expand into other facets of the business.
Max is responsible for overseeing the group of companies. Max started his career in construction over two decades ago as President of De Angelis Construction Inc. Max is an innovative and results-oriented construction professional with extensive experience in all facets of construction across Ontario and Canada. Through his commitment to excellence and a team-oriented approach, Max has been a catalyst in establishing the trusted Hurricane name.


Detects
package
statements that do not correspond to the project directory structure and reports classes without
package
statements.


This document is the API specification for the Deep Java Library (DJL).
The key design goal for the DJL is to simplify the use of deep learning for Java developers. Developers don't need to be machine learning/deep learning experts to get started. They can start with their existing Java expertise as a foundation to learn and use ML/DL. Developers can use their favorite IDE to build, train, and deploy their models. They can also easily integrate these models with their Java applications. They don't have to compromise on model performance, scale, or choice of GPU vs. CPUs.
DJL is deep learning engine agnostic. Developers don't have to make a choice between engines when they start their project. They can switch to a different engine at any time.
DJL provides a native Java development experience and functions just like any other regular Java library would. DJL's ergonomic API interface is designed to guide developers with best practices to accomplish deep learning tasks.
The following is an example of how to write inference code:
// Assume user has a pre-trained already, they just need load it Model model = Model.load(modelDir, modelName); // User can implement Translator interface, read Translator for detail. Translator translator = new MyTranslator(); // Next user need create a Predictor, and use Predictor.predict() // to get prediction. try (Predictor<Image, DetectedObjects> predictor = model.newPredictor(translator)) { DetectedObjects result = predictor.predict(img); }
More tutorials, documents, and examples can be on our GitHub repository.