object storage documentation updates

Author: rcohenma

docs/object_storage/namespaces.md

@@ -11,8 +11,8 @@ The following attributes are exported:
 
 
 ### Get Operation
-Gets the name of the namespace for the user making the request. An account name must be unique, must start with a
-letter, and can have up to 15 lowercase letters and numbers. You cannot use spaces or special characters.
+Namespaces are unique. Namespaces are either the tenancy name or a random string automatically generated during
+account creation. You cannot edit a namespace.
 
 
 The following arguments are supported:

docs/object_storage/preauthenticated_requests.md

@@ -6,30 +6,30 @@
 
 The following attributes are exported:
 
-* `access_type` - the operation that can be performed on this resource e.g PUT or GET.
+* `access_type` - The operation that can be performed on this resource.
 * `access_uri` - The URI to embed in the URL when using the pre-authenticated request.
-* `bucket` - (Required) The name of the bucket.  Example: `my-new-bucket1` 
-* `id` - the unique identifier to use when directly addressing the pre-authenticated request
-* `name` - the user supplied name of the pre-authenticated request
-* `namespace` - (Required) The top-level namespace used for the request.
-* `object` - Name of object that is being granted access to by the pre-authenticated request. This can be null and that would mean that the pre-authenticated request is granting access to the entire bucket
-* `time_created` - the date when the pre-authenticated request was created as per spec [RFC 3339](https://tools.ietf.org/rfc/rfc3339) 
-* `time_expires` - the expiration date after which the pre authenticated request will no longer be valid as per spec [RFC 3339](https://tools.ietf.org/rfc/rfc3339) 
+* `bucket` - The name of the bucket.  Example: `my-new-bucket1` 
+* `id` - The unique identifier to use when directly addressing the pre-authenticated request.
+* `name` - The user-provided name of the pre-authenticated request.
+* `namespace` - The top-level namespace used for the request.
+* `object` - The name of object that is being granted access to by the pre-authenticated request. This can be null and if it is, the pre-authenticated request grants access to the entire bucket.
+* `time_created` - The date when the pre-authenticated request was created as per [RFC 3339](https://tools.ietf.org/rfc/rfc3339). 
+* `time_expires` - The expiration date for the pre-authenticated request as per [RFC 3339](https://tools.ietf.org/rfc/rfc3339). After this date the pre-authenticated request will no longer be valid. 
 
 
 
 ### Create Operation
-Create a pre-authenticated request specific to the bucket
+Creates a pre-authenticated request specific to the bucket.
 
 
 The following arguments are supported:
 
-* `access_type` - (Required) the operation that can be performed on this resource e.g PUT or GET.
-* `bucket` - (Required) The name of the bucket.  Example: `my-new-bucket1` 
-* `name` - (Required) user specified name for pre-authenticated request. Helpful for management purposes.
+* `access_type` - (Required) The operation that can be performed on this resource.
+* `bucket` - (Required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` 
+* `name` - (Required) A user-specified name for the pre-authenticated request. Helpful for management purposes.
 * `namespace` - (Required) The top-level namespace used for the request.
-* `object` - (Optional) Name of object that is being granted access to by the pre-authenticated request. This can be null and that would mean that the pre-authenticated request is granting access to the entire bucket
-* `time_expires` - (Required) The expiration date after which the pre-authenticated request will no longer be valid per spec [RFC 3339](https://tools.ietf.org/rfc/rfc3339) 
+* `object` - (Optional) The name of object that is being granted access to by the pre-authenticated request. This can be null and if it is, the pre-authenticated request grants access to the entire bucket.
+* `time_expires` - (Required) The expiration date for the pre-authenticated request as per [RFC 3339](https://tools.ietf.org/rfc/rfc3339). After this date the pre-authenticated request will no longer be valid. 
 
 
 ### Update Operation