Api-roll 45: 2017-02-13

discovery/googleapis/deploymentmanager__v2.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/ndev.cloudman": {
                     "description": "View and manage your Google Cloud Platform management resources and deployment status information"
                 },
                 "https://www.googleapis.com/auth/ndev.cloudman.readonly": {
                     "description": "View your Google Cloud Platform management resources and deployment status information"
                 }
             }
         }
     },
     "basePath": "/deploymentmanager/v2/projects/",
     "baseUrl": "https://www.googleapis.com/deploymentmanager/v2/projects/",
     "batchPath": "batch",
     "canonicalName": "Deployment Manager",
     "description": "Declares, configures, and deploys complex solutions on Google Cloud Platform.",
     "discoveryVersion": "v1",
     "documentationLink": "https://cloud.google.com/deployment-manager/",
-    "etag": "\"tbys6C40o18GZwyMen5GMkdK-3s/Dg3jkuWJLyfsWpZiK_LBaeIV21s\"",
+    "etag": "\"tbys6C40o18GZwyMen5GMkdK-3s/BZOTaOSd6CDPT3kBLAME2ENtrqQ\"",
     "icons": {
         "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png",
         "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png"
     },
     "id": "deploymentmanager:v2",
     "kind": "discovery#restDescription",
     "name": "deploymentmanager",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
@@ skipping 237 matching lines @@
                         "project"
                     ],
                     "parameters": {
                         "filter": {
                             "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nYou can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.\n\nTo filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests. Acceptable values are 0 to 500, inclusive. (Default: 500)",
                             "format": "uint32",
                             "location": "query",
-                            "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "orderBy": {
                             "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation timestamp using orderBy=\"creationTimestamp desc\". This sorts results based on the creationTimestamp field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by name or creationTimestamp desc is supported.",
                             "location": "query",
                             "type": "string"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
@@ skipping 330 matching lines @@
                             "required": true,
                             "type": "string"
                         },
                         "filter": {
                             "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nYou can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.\n\nTo filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests. Acceptable values are 0 to 500, inclusive. (Default: 500)",
                             "format": "uint32",
                             "location": "query",
-                            "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "orderBy": {
                             "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation timestamp using orderBy=\"creationTimestamp desc\". This sorts results based on the creationTimestamp field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by name or creationTimestamp desc is supported.",
                             "location": "query",
                             "type": "string"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
@@ skipping 65 matching lines @@
                         "project"
                     ],
                     "parameters": {
                         "filter": {
                             "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nYou can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.\n\nTo filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests. Acceptable values are 0 to 500, inclusive. (Default: 500)",
                             "format": "uint32",
                             "location": "query",
-                            "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "orderBy": {
                             "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation timestamp using orderBy=\"creationTimestamp desc\". This sorts results based on the creationTimestamp field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by name or creationTimestamp desc is supported.",
                             "location": "query",
                             "type": "string"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
@@ skipping 81 matching lines @@
                             "required": true,
                             "type": "string"
                         },
                         "filter": {
                             "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nYou can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.\n\nTo filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests. Acceptable values are 0 to 500, inclusive. (Default: 500)",
                             "format": "uint32",
                             "location": "query",
-                            "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "orderBy": {
                             "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation timestamp using orderBy=\"creationTimestamp desc\". This sorts results based on the creationTimestamp field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by name or creationTimestamp desc is supported.",
                             "location": "query",
                             "type": "string"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
@@ skipping 31 matching lines @@
                         "project"
                     ],
                     "parameters": {
                         "filter": {
                             "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nYou can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.\n\nTo filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests. Acceptable values are 0 to 500, inclusive. (Default: 500)",
                             "format": "uint32",
                             "location": "query",
-                            "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "orderBy": {
                             "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation timestamp using orderBy=\"creationTimestamp desc\". This sorts results based on the creationTimestamp field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by name or creationTimestamp desc is supported.",
                             "location": "query",
                             "type": "string"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
@@ skipping 15 matching lines @@
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/cloud-platform.read-only",
                         "https://www.googleapis.com/auth/ndev.cloudman",
                         "https://www.googleapis.com/auth/ndev.cloudman.readonly"
                     ]
                 }
             }
         }
     },
-    "revision": "20161221",
+    "revision": "20170126",
     "rootUrl": "https://www.googleapis.com/",
     "schemas": {
         "AuditConfig": {
-            "description": "Provides the configuration for non-admin_activity logging for a service. Controls exemptions and specific log sub-types.",
+            "description": "Specifies the audit configuration for a service. It consists of which permission types are logged, and what identities, if any, are exempted from logging. An AuditConifg must have one or more AuditLogConfigs.",
             "id": "AuditConfig",
             "properties": {
                 "auditLogConfigs": {
-                    "description": "The configuration for each type of logging",
+                    "description": "The configuration for logging of each type of permission.",
                     "items": {
                         "$ref": "AuditLogConfig"
                     },
                     "type": "array"
                 },
                 "exemptedMembers": {
-                    "description": "Specifies the identities that are exempted from \"data access\" audit logging for the `service` specified above. Follows the same format of Binding.members.",
+                    "description": "Specifies the identities that are exempted from \"data access\" audit logging for the `service` specified above. Follows the same format of Binding.members. This field is deprecated in favor of per-permission-type exemptions.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "service": {
                     "description": "Specifies a service that will be enabled for audit logging. For example, `resourcemanager`, `storage`, `compute`. `allServices` is a special value that covers all services.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "AuditLogConfig": {
-            "description": "Provides the configuration for a sub-type of logging.",
+            "description": "Provides the configuration for logging a type of permissions. Example:\n\n{ \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\", \"exempted_members\": [ \"user:foo@gmail.com\" ] }, { \"log_type\": \"DATA_WRITE\", } ] }\n\nThis enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting foo@gmail.com from DATA_READ logging.",
             "id": "AuditLogConfig",
             "properties": {
                 "exemptedMembers": {
-                    "description": "Specifies the identities that are exempted from this type of logging Follows the same format of Binding.members.",
+                    "description": "Specifies the identities that do not cause logging for this type of permission. Follows the same format of [Binding.members][].",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "logType": {
                     "description": "The log type that this config enables.",
                     "type": "string"
                 }
             },
@@ skipping 127 matching lines @@
                 "value": {
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "DeploymentUpdate": {
             "description": "",
             "id": "DeploymentUpdate",
             "properties": {
+                "description": {
+                    "description": "[Output Only] An optional user-provided description of the deployment after the current update has been applied.",
+                    "type": "string"
+                },
                 "labels": {
                     "description": "[Output Only] Map of labels; provided by the client when the resource is created or updated. Specifically: Label keys must be between 1 and 63 characters long and must conform to the following regular expression: [a-z]([-a-z0-9]*[a-z0-9])? Label values must be between 0 and 63 characters long and must conform to the regular expression ([a-z]([-a-z0-9]*[a-z0-9])?)?",
                     "items": {
                         "$ref": "DeploymentUpdateLabelEntry"
                     },
                     "type": "array"
                 },
                 "manifest": {
                     "description": "[Output Only] URL of the manifest representing the update configuration of this deployment.",
                     "type": "string"
@@ skipping 159 matching lines @@
         },
         "Operation": {
             "description": "An Operation resource, used to manage asynchronous API requests.",
             "id": "Operation",
             "properties": {
                 "clientOperationId": {
                     "description": "[Output Only] Reserved for future use.",
                     "type": "string"
                 },
                 "creationTimestamp": {
-                    "description": "[Output Only] Creation timestamp in RFC3339 text format.",
+                    "description": "[Deprecated] This field is deprecated.",
                     "type": "string"
                 },
                 "description": {
                     "description": "[Output Only] A textual description of the operation, which is set when the operation is created.",
                     "type": "string"
                 },
                 "endTime": {
                     "description": "[Output Only] The time that this operation was completed. This value is in RFC3339 text format.",
                     "type": "string"
                 },
@@ skipping 150 matching lines @@
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "Policy": {
             "description": "Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources.\n\n\n\nA `Policy` consists of a list of `bindings`. A `Binding` binds a list of `members` to a `role`, where the members can be user accounts, Google groups, Google domains, and service accounts. A `role` is a named list of permissions defined by IAM.\n\n**Example**\n\n{ \"bindings\": [ { \"role\": \"roles/owner\", \"members\": [ \"user:mike@example.com\", \"group:admins@example.com\", \"domain:google.com\", \"serviceAccount:my-other-app@appspot.gserviceaccount.com\", ] }, { \"role\": \"roles/viewer\", \"members\": [\"user:sean@example.com\"] } ] }\n\nFor a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam).",
             "id": "Policy",
             "properties": {
                 "auditConfigs": {
-                    "description": "Specifies audit logging configs for \"data access\". \"data access\": generally refers to data reads/writes and admin reads. \"admin activity\": generally refers to admin writes.\n\nNote: `AuditConfig` doesn't apply to \"admin activity\", which always enables audit logging.",
+                    "description": "Specifies cloud audit logging configuration for this policy.",
                     "items": {
                         "$ref": "AuditConfig"
                     },
                     "type": "array"
                 },
                 "bindings": {
                     "description": "Associates a list of `members` to a `role`. Multiple `bindings` must not be specified for the same `role`. `bindings` with no members will result in an error.",
                     "items": {
                         "$ref": "Binding"
                     },
@@ skipping 368 matching lines @@
                     "type": "array"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "deploymentmanager/v2/projects/",
     "title": "Google Cloud Deployment Manager API",
     "version": "v2"
 }