Api-roll 42: 2016-11-08

discovery/googleapis/storage__v1.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
                 "https://www.googleapis.com/auth/cloud-platform": {
                     "description": "View and manage your data across Google Cloud Platform services"
                 },
                 "https://www.googleapis.com/auth/cloud-platform.read-only": {
                     "description": "View your data across Google Cloud Platform services"
                 },
                 "https://www.googleapis.com/auth/devstorage.full_control": {
                     "description": "Manage your data and permissions in Google Cloud Storage"
                 },
                 "https://www.googleapis.com/auth/devstorage.read_only": {
                     "description": "View your data in Google Cloud Storage"
                 },
                 "https://www.googleapis.com/auth/devstorage.read_write": {
                     "description": "Manage your data in Google Cloud Storage"
                 }
             }
         }
     },
     "basePath": "/storage/v1/",
     "baseUrl": "https://www.googleapis.com/storage/v1/",
     "batchPath": "batch",
     "description": "Stores and retrieves potentially large, immutable data objects.",
     "discoveryVersion": "v1",
     "documentationLink": "https://developers.google.com/storage/docs/json_api/",
-    "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/gtcWNCypj7VTDxrk1rvvuniNHZo\"",
+    "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/VwfrBbrm1x1NC_RQejLBiqBNNFk\"",
     "icons": {
         "x16": "https://www.google.com/images/icons/product/cloud_storage-16.png",
         "x32": "https://www.google.com/images/icons/product/cloud_storage-32.png"
     },
     "id": "storage:v1",
     "kind": "discovery#restDescription",
     "labels": [
         "labs"
     ],
     "name": "storage",
@@ skipping 448 matching lines @@
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/cloud-platform.read-only",
                         "https://www.googleapis.com/auth/devstorage.full_control",
                         "https://www.googleapis.com/auth/devstorage.read_only",
                         "https://www.googleapis.com/auth/devstorage.read_write"
                     ]
                 },
                 "patch": {
-                    "description": "Updates a bucket. This method supports patch semantics.",
+                    "description": "Updates a bucket. Changes to the bucket will be readable immediately after writing, but configuration changes may take time to propagate. This method supports patch semantics.",
                     "httpMethod": "PATCH",
                     "id": "storage.buckets.patch",
                     "parameterOrder": [
                         "bucket"
                     ],
                     "parameters": {
                         "bucket": {
                             "description": "Name of a bucket.",
                             "location": "path",
                             "required": true,
@@ skipping 71 matching lines @@
                     },
                     "response": {
                         "$ref": "Bucket"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/devstorage.full_control"
                     ]
                 },
                 "update": {
-                    "description": "Updates a bucket.",
+                    "description": "Updates a bucket. Changes to the bucket will be readable immediately after writing, but configuration changes may take time to propagate.",
                     "httpMethod": "PUT",
                     "id": "storage.buckets.update",
                     "parameterOrder": [
                         "bucket"
                     ],
                     "parameters": {
                         "bucket": {
                             "description": "Name of a bucket.",
                             "location": "path",
                             "required": true,
@@ skipping 602 matching lines @@
                             "description": "Makes the operation conditional on whether the object's current generation matches the given value.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
                         "ifMetagenerationMatch": {
                             "description": "Makes the operation conditional on whether the object's current metageneration matches the given value.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
-                        },
-                        "kmsKeyName": {
-                            "description": "Resource name of the Cloud KMS key, of the form projects/my-project/locations/global/keyRings/my-kr/cryptoKeys/my-key, that will be used to encrypt the object. Overrides the object metadata's kms_key_name value, if any.",
-                            "location": "query",
-                            "type": "string"
                         }
                     },
                     "path": "b/{destinationBucket}/o/{destinationObject}/compose",
                     "request": {
                         "$ref": "ComposeRequest"
                     },
                     "response": {
                         "$ref": "Object"
                     },
                     "scopes": [
@@ skipping 329 matching lines @@
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
                         "ifMetagenerationNotMatch": {
                             "description": "Makes the operation conditional on whether the object's current metageneration does not match the given value.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
-                        "kmsKeyName": {
-                            "description": "Resource name of the Cloud KMS key, of the form projects/my-project/locations/global/keyRings/my-kr/cryptoKeys/my-key, that will be used to encrypt the object. Overrides the object metadata's kms_key_name value, if any.",
-                            "location": "query",
-                            "type": "string"
-                        },
                         "name": {
                             "description": "Name of the object. Required when the object metadata is not otherwise provided. Overrides the object metadata's name value, if any. For information about how to URL encode object names to be path safe, see Encoding URI Path Parts.",
                             "location": "query",
                             "type": "string"
                         },
                         "predefinedAcl": {
                             "description": "Apply a predefined set of access controls to this object.",
                             "enum": [
                                 "authenticatedRead",
                                 "bucketOwnerFullControl",
@@ skipping 218 matching lines @@
                         "destinationBucket",
                         "destinationObject"
                     ],
                     "parameters": {
                         "destinationBucket": {
                             "description": "Name of the bucket in which to store the new object. Overrides the provided object metadata's bucket value, if any.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         },
-                        "destinationKmsKeyName": {
-                            "description": "Resource name of the Cloud KMS key, of the form projects/my-project/locations/global/keyRings/my-kr/cryptoKeys/my-key, that will be used to encrypt the object. Overrides the object metadata's kms_key_name value, if any.",
-                            "location": "query",
-                            "type": "string"
-                        },
                         "destinationObject": {
                             "description": "Name of the new object. Required when the object metadata is not otherwise provided. Overrides the object metadata's name value, if any. For information about how to URL encode object names to be path safe, see Encoding URI Path Parts.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         },
                         "destinationPredefinedAcl": {
                             "description": "Apply a predefined set of access controls to the destination object.",
                             "enum": [
                                 "authenticatedRead",
@@ skipping 285 matching lines @@
                         "https://www.googleapis.com/auth/cloud-platform.read-only",
                         "https://www.googleapis.com/auth/devstorage.full_control",
                         "https://www.googleapis.com/auth/devstorage.read_only",
                         "https://www.googleapis.com/auth/devstorage.read_write"
                     ],
                     "supportsSubscription": true
                 }
             }
         }
     },
-    "revision": "20160802",
+    "revision": "20161027",
     "rootUrl": "https://www.googleapis.com/",
     "schemas": {
         "Bucket": {
             "description": "A bucket.",
             "id": "Bucket",
             "properties": {
                 "acl": {
                     "annotations": {
                         "required": [
                             "storage.buckets.update"
@@ skipping 40 matching lines @@
                     },
                     "type": "array"
                 },
                 "defaultObjectAcl": {
                     "description": "Default access controls to apply to new objects when no ACL is provided.",
                     "items": {
                         "$ref": "ObjectAccessControl"
                     },
                     "type": "array"
                 },
-                "encryption": {
-                    "description": "Encryption configuration used by default for newly inserted objects, when no encryption config is specified.",
-                    "properties": {
-                        "default_kms_key_name": {
-                            "type": "string"
-                        }
-                    },
-                    "type": "object"
-                },
                 "etag": {
                     "description": "HTTP 1.1 Entity tag for the bucket.",
                     "type": "string"
                 },
                 "id": {
                     "description": "The ID of the bucket.",
                     "type": "string"
                 },
                 "kind": {
                     "default": "storage#bucket",
                     "description": "The kind of item this is. For buckets, this is always storage#bucket.",
                     "type": "string"
                 },
                 "lifecycle": {
                     "description": "The bucket's lifecycle configuration. See lifecycle management for more information.",
                     "properties": {
                         "rule": {
                             "description": "A lifecycle management rule, which is made of an action to take and the condition(s) under which the action will be taken.",
                             "items": {
                                 "properties": {
                                     "action": {
                                         "description": "The action to take.",
                                         "properties": {
+                                            "storageClass": {
+                                                "description": "Target storage class. Required iff the type of the action is SetStorageClass.",
+                                                "type": "string"
+                                            },
                                             "type": {
-                                                "description": "Type of the action. Currently, only Delete is supported.",
+                                                "description": "Type of the action. Currently, only Delete and SetStorageClass are supported.",
                                                 "type": "string"
                                             }
                                         },
                                         "type": "object"
                                     },
                                     "condition": {
                                         "description": "The condition(s) under which the action will be taken.",
                                         "properties": {
                                             "age": {
                                                 "description": "Age of an object (in days). This condition is satisfied when an object reaches the specified age.",
                                                 "format": "int32",
                                                 "type": "integer"
                                             },
                                             "createdBefore": {
                                                 "description": "A date in RFC 3339 format with only the date part (for instance, \"2013-01-15\"). This condition is satisfied when an object is created before midnight of the specified date in UTC.",
                                                 "format": "date",
                                                 "type": "string"
                                             },
                                             "isLive": {
                                                 "description": "Relevant only for versioned objects. If the value is true, this condition matches live objects; if the value is false, it matches archived objects.",
                                                 "type": "boolean"
                                             },
+                                            "matchesStorageClass": {
+                                                "description": "Objects having any of the storage classes specified by this condition will be matched. Values include MULTI_REGIONAL, REGIONAL, NEARLINE, COLDLINE, STANDARD, and DURABLE_REDUCED_AVAILABILITY.",
+                                                "items": {
+                                                    "type": "string"
+                                                },
+                                                "type": "array"
+                                            },
                                             "numNewerVersions": {
                                                 "description": "Relevant only for versioned objects. If the value is N, this condition is satisfied when there are at least N versions (including the live version) newer than this version of the object.",
                                                 "format": "int32",
                                                 "type": "integer"
                                             }
                                         },
                                         "type": "object"
                                     }
                                 },
                                 "type": "object"
@@ skipping 52 matching lines @@
                 "projectNumber": {
                     "description": "The project number of the project the bucket belongs to.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "The URI of this bucket.",
                     "type": "string"
                 },
                 "storageClass": {
-                    "description": "The bucket's storage class. This defines how objects in the bucket are stored and determines the SLA and the cost of storage. Values include STANDARD, NEARLINE and DURABLE_REDUCED_AVAILABILITY. Defaults to STANDARD. For more information, see storage classes.",
+                    "description": "The bucket's default storage class, used whenever no storageClass is specified for a newly-created object. This defines how objects in the bucket are stored and determines the SLA and the cost of storage. Values include MULTI_REGIONAL, REGIONAL, STANDARD, NEARLINE, COLDLINE, and DURABLE_REDUCED_AVAILABILITY. If this value is not specified when the bucket is created, it will default to STANDARD. For more information, see storage classes.",
                     "type": "string"
                 },
                 "timeCreated": {
                     "description": "The creation time of the bucket in RFC 3339 format.",
                     "format": "date-time",
                     "type": "string"
                 },
                 "updated": {
                     "description": "The modification time of the bucket in RFC 3339 format.",
                     "format": "date-time",
@@ skipping 322 matching lines @@
                 },
                 "id": {
                     "description": "The ID of the object.",
                     "type": "string"
                 },
                 "kind": {
                     "default": "storage#object",
                     "description": "The kind of item this is. For objects, this is always storage#object.",
                     "type": "string"
                 },
-                "kmsKeyName": {
-                    "description": "Cloud KMS Key used to encrypt this object, if the object is encrypted by such a key.",
-                    "type": "string"
-                },
                 "md5Hash": {
                     "description": "MD5 hash of the data; encoded using base64. For more information about using the MD5 hash, see Hashes and ETags: Best Practices.",
                     "type": "string"
                 },
                 "mediaLink": {
                     "description": "Media download link.",
                     "type": "string"
                 },
                 "metadata": {
                     "additionalProperties": {
@@ skipping 67 matching lines @@
                 },
                 "domain": {
                     "description": "The domain associated with the entity, if any.",
                     "type": "string"
                 },
                 "email": {
                     "description": "The email address associated with the entity, if any.",
                     "type": "string"
                 },
                 "entity": {
+                    "annotations": {
+                        "required": [
+                            "storage.defaultObjectAccessControls.insert",
+                            "storage.objectAccessControls.insert"
+                        ]
+                    },
                     "description": "The entity holding the permission, in one of the following forms: \n- user-userId \n- user-email \n- group-groupId \n- group-email \n- domain-domain \n- project-team-projectId \n- allUsers \n- allAuthenticatedUsers Examples: \n- The user liz@example.com would be user-liz@example.com. \n- The group example@googlegroups.com would be group-example@googlegroups.com. \n- To refer to all members of the Google Apps for Business domain example.com, the entity would be domain-example.com.",
                     "type": "string"
                 },
                 "entityId": {
                     "description": "The ID for the entity, if any.",
                     "type": "string"
                 },
                 "etag": {
                     "description": "HTTP 1.1 Entity tag for the access-control entry.",
                     "type": "string"
                 },
                 "generation": {
-                    "description": "The content generation of the object.",
+                    "description": "The content generation of the object, if applied to an object.",
                     "format": "int64",
                     "type": "string"
                 },
                 "id": {
                     "description": "The ID of the access-control entry.",
                     "type": "string"
                 },
                 "kind": {
                     "default": "storage#objectAccessControl",
                     "description": "The kind of item this is. For object access control entries, this is always storage#objectAccessControl.",
                     "type": "string"
                 },
                 "object": {
-                    "description": "The name of the object.",
+                    "description": "The name of the object, if applied to an object.",
                     "type": "string"
                 },
                 "projectTeam": {
                     "description": "The project team associated with the entity, if any.",
                     "properties": {
                         "projectNumber": {
                             "description": "The project number.",
                             "type": "string"
                         },
                         "team": {
                             "description": "The team.",
                             "type": "string"
                         }
                     },
                     "type": "object"
                 },
                 "role": {
+                    "annotations": {
+                        "required": [
+                            "storage.defaultObjectAccessControls.insert",
+                            "storage.objectAccessControls.insert"
+                        ]
+                    },
                     "description": "The access permission for the entity.",
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "The link to this access-control entry.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "ObjectAccessControls": {
             "description": "An access-control list.",
             "id": "ObjectAccessControls",
             "properties": {
                 "items": {
                     "description": "The list of items.",
                     "items": {
-                        "type": "any"
+                        "$ref": "ObjectAccessControl"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "storage#objectAccessControls",
                     "description": "The kind of item this is. For lists of object access control entries, this is always storage#objectAccessControls.",
                     "type": "string"
                 }
             },
             "type": "object"
@@ skipping 60 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "storage/v1/",
     "title": "Cloud Storage JSON API",
     "version": "v1"
 }