Api-roll 33: 2016-03-14

discovery/googleapis_beta/dataproc__v1beta1.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
                 "https://www.googleapis.com/auth/cloud-platform": {
                     "description": "View and manage your data across Google Cloud Platform services"
                 }
             }
         }
     },
     "basePath": "",
     "baseUrl": "https://dataproc.googleapis.com/",
     "batchPath": "batch",
     "description": "An API for managing Hadoop-based clusters and jobs on Google Cloud Platform.",
     "discoveryVersion": "v1",
     "documentationLink": "https://cloud.google.com/dataproc/",
-    "etag": "\"bRFOOrZKfO9LweMbPqu0kcu6De8/J2wq1WcZfpjeQfZa1hSleFHi_7g\"",
+    "etag": "\"bRFOOrZKfO9LweMbPqu0kcu6De8/moJSD8ChiA3_GeWvn2rNFBXMhlQ\"",
     "icons": {
         "x16": "http://www.google.com/images/icons/product/search-16.gif",
         "x32": "http://www.google.com/images/icons/product/search-32.gif"
     },
     "id": "dataproc:v1beta1",
     "kind": "discovery#restDescription",
     "name": "dataproc",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
@@ skipping 264 matching lines @@
                             "path": "v1beta1/projects/{projectId}/clusters/{clusterName}:diagnose",
                             "request": {
                                 "$ref": "DiagnoseClusterRequest"
                             },
                             "response": {
                                 "$ref": "Operation"
                             },
                             "scopes": [
                                 "https://www.googleapis.com/auth/cloud-platform"
                             ]
+                        },
+                        "setIamPolicy": {
+                            "description": "Sets the access control policy on the specified resource. Replaces any existing policy.",
+                            "httpMethod": "POST",
+                            "id": "dataproc.projects.clusters.setIamPolicy",
+                            "parameterOrder": [
+                                "resource"
+                            ],
+                            "parameters": {
+                                "resource": {
+                                    "description": "REQUIRED: The resource for which the policy is being specified. `resource` is usually specified as a path, such as `projects/*project*/zones/*zone*/disks/*disk*`. The format for the path specified in this value is resource specific and is specified in the `setIamPolicy` documentation.",
+                                    "location": "path",
+                                    "pattern": "^projects/[^/]*/clusters/[^/]*$",
+                                    "required": true,
+                                    "type": "string"
+                                }
+                            },
+                            "path": "v1beta1/{+resource}:setIamPolicy",
+                            "request": {
+                                "$ref": "SetIamPolicyRequest"
+                            },
+                            "response": {
+                                "$ref": "Policy"
+                            },
+                            "scopes": [
+                                "https://www.googleapis.com/auth/cloud-platform"
+                            ]
+                        },
+                        "getIamPolicy": {
+                            "description": "Gets the access control policy for a `resource`. Returns an empty policy if the resource exists and does not have a policy set.",
+                            "httpMethod": "GET",
+                            "id": "dataproc.projects.clusters.getIamPolicy",
+                            "parameterOrder": [
+                                "resource"
+                            ],
+                            "parameters": {
+                                "resource": {
+                                    "description": "REQUIRED: The resource for which the policy is being requested. `resource` is usually specified as a path, such as `projects/*project*/zones/*zone*/disks/*disk*`. The format for the path specified in this value is resource specific and is specified in the `getIamPolicy` documentation.",
+                                    "location": "path",
+                                    "pattern": "^projects/[^/]*/clusters/[^/]*$",
+                                    "required": true,
+                                    "type": "string"
+                                }
+                            },
+                            "path": "v1beta1/{+resource}:getIamPolicy",
+                            "response": {
+                                "$ref": "Policy"
+                            },
+                            "scopes": [
+                                "https://www.googleapis.com/auth/cloud-platform"
+                            ]
+                        },
+                        "testIamPermissions": {
+                            "description": "Returns permissions that a caller has on the specified resource.",
+                            "httpMethod": "POST",
+                            "id": "dataproc.projects.clusters.testIamPermissions",
+                            "parameterOrder": [
+                                "resource"
+                            ],
+                            "parameters": {
+                                "resource": {
+                                    "description": "REQUIRED: The resource for which the policy detail is being requested. `resource` is usually specified as a path, such as `projects/*project*/zones/*zone*/disks/*disk*`. The format for the path specified in this value is resource specific and is specified in the `testIamPermissions` documentation.",
+                                    "location": "path",
+                                    "pattern": "^projects/[^/]*/clusters/[^/]*$",
+                                    "required": true,
+                                    "type": "string"
+                                }
+                            },
+                            "path": "v1beta1/{+resource}:testIamPermissions",
+                            "request": {
+                                "$ref": "TestIamPermissionsRequest"
+                            },
+                            "response": {
+                                "$ref": "TestIamPermissionsResponse"
+                            },
+                            "scopes": [
+                                "https://www.googleapis.com/auth/cloud-platform"
+                            ]
                         }
                     }
                 },
                 "jobs": {
                     "methods": {
                         "submit": {
                             "description": "Submits a job to a cluster.",
                             "httpMethod": "POST",
                             "id": "dataproc.projects.jobs.submit",
                             "parameterOrder": [
@@ skipping 152 matching lines @@
                                     "type": "string"
                                 }
                             },
                             "path": "v1beta1/projects/{projectId}/jobs/{jobId}",
                             "response": {
                                 "$ref": "Empty"
                             },
                             "scopes": [
                                 "https://www.googleapis.com/auth/cloud-platform"
                             ]
+                        },
+                        "setIamPolicy": {
+                            "description": "Sets the access control policy on the specified resource. Replaces any existing policy.",
+                            "httpMethod": "POST",
+                            "id": "dataproc.projects.jobs.setIamPolicy",
+                            "parameterOrder": [
+                                "resource"
+                            ],
+                            "parameters": {
+                                "resource": {
+                                    "description": "REQUIRED: The resource for which the policy is being specified. `resource` is usually specified as a path, such as `projects/*project*/zones/*zone*/disks/*disk*`. The format for the path specified in this value is resource specific and is specified in the `setIamPolicy` documentation.",
+                                    "location": "path",
+                                    "pattern": "^projects/[^/]*/jobs/[^/]*$",
+                                    "required": true,
+                                    "type": "string"
+                                }
+                            },
+                            "path": "v1beta1/{+resource}:setIamPolicy",
+                            "request": {
+                                "$ref": "SetIamPolicyRequest"
+                            },
+                            "response": {
+                                "$ref": "Policy"
+                            },
+                            "scopes": [
+                                "https://www.googleapis.com/auth/cloud-platform"
+                            ]
+                        },
+                        "getIamPolicy": {
+                            "description": "Gets the access control policy for a `resource`. Returns an empty policy if the resource exists and does not have a policy set.",
+                            "httpMethod": "GET",
+                            "id": "dataproc.projects.jobs.getIamPolicy",
+                            "parameterOrder": [
+                                "resource"
+                            ],
+                            "parameters": {
+                                "resource": {
+                                    "description": "REQUIRED: The resource for which the policy is being requested. `resource` is usually specified as a path, such as `projects/*project*/zones/*zone*/disks/*disk*`. The format for the path specified in this value is resource specific and is specified in the `getIamPolicy` documentation.",
+                                    "location": "path",
+                                    "pattern": "^projects/[^/]*/jobs/[^/]*$",
+                                    "required": true,
+                                    "type": "string"
+                                }
+                            },
+                            "path": "v1beta1/{+resource}:getIamPolicy",
+                            "response": {
+                                "$ref": "Policy"
+                            },
+                            "scopes": [
+                                "https://www.googleapis.com/auth/cloud-platform"
+                            ]
+                        },
+                        "testIamPermissions": {
+                            "description": "Returns permissions that a caller has on the specified resource.",
+                            "httpMethod": "POST",
+                            "id": "dataproc.projects.jobs.testIamPermissions",
+                            "parameterOrder": [
+                                "resource"
+                            ],
+                            "parameters": {
+                                "resource": {
+                                    "description": "REQUIRED: The resource for which the policy detail is being requested. `resource` is usually specified as a path, such as `projects/*project*/zones/*zone*/disks/*disk*`. The format for the path specified in this value is resource specific and is specified in the `testIamPermissions` documentation.",
+                                    "location": "path",
+                                    "pattern": "^projects/[^/]*/jobs/[^/]*$",
+                                    "required": true,
+                                    "type": "string"
+                                }
+                            },
+                            "path": "v1beta1/{+resource}:testIamPermissions",
+                            "request": {
+                                "$ref": "TestIamPermissionsRequest"
+                            },
+                            "response": {
+                                "$ref": "TestIamPermissionsResponse"
+                            },
+                            "scopes": [
+                                "https://www.googleapis.com/auth/cloud-platform"
+                            ]
                         }
                     }
                 }
             }
         },
         "operations": {
             "methods": {
                 "get": {
                     "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.",
                     "httpMethod": "GET",
@@ skipping 105 matching lines @@
                     "response": {
                         "$ref": "Empty"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform"
                     ]
                 }
             }
         }
     },
-    "revision": "20151209",
+    "revision": "20160219",
     "rootUrl": "https://dataproc.googleapis.com/",
     "schemas": {
         "Cluster": {
             "description": "Describes the identifying information, configuration, and status of a cluster of Google Compute Engine instances.",
             "id": "Cluster",
             "properties": {
                 "projectId": {
                     "description": "[Required] The Google Cloud Platform project ID that the cluster belongs to.",
                     "type": "string"
                 },
@@ skipping 59 matching lines @@
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "GceClusterConfiguration": {
             "description": "Common configuration settings for resources of Google Compute Engine cluster instances, applicable to all instances in the cluster.",
             "id": "GceClusterConfiguration",
             "properties": {
                 "zoneUri": {
-                    "description": "[Required] The zone where the Google Compute Engine cluster will be located. Example: `compute.googleapis.com/projects/[project_id]/zones/us-east1-a`.",
+                    "description": "[Required] The zone where the Google Compute Engine cluster will be located. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/[zone]`.",
                     "type": "string"
                 },
                 "networkUri": {
-                    "description": "The Google Compute Engine network to be used for machine communications. Inbound SSH connections are necessary to complete cluster configuration. Example: `compute.googleapis.com/projects/[project_id]/zones/us-east1-a/default`.",
+                    "description": "The Google Compute Engine network to be used for machine communications. Cannot be specified with subnetwork_uri. If neither network_uri nor subnetwork_uri is specified, the \"default\" network of the project is used, if it exists. Cannot be a \"Custom Subnet Network\" (see https://cloud.google.com/compute/docs/subnetworks for more information). Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/global/default`.",
+                    "type": "string"
+                },
+                "subnetworkUri": {
+                    "description": "The Google Compute Engine subnetwork to be used for machine communications. Cannot be specified with network_uri. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/us-east1/sub0`.",
                     "type": "string"
                 },
                 "serviceAccountScopes": {
                     "description": "The URIs of service account scopes to be included in Google Compute Engine instances. The following base set of scopes is always included: - https://www.googleapis.com/auth/cloud.useraccounts.readonly - https://www.googleapis.com/auth/devstorage.read_write - https://www.googleapis.com/auth/logging.write If no scopes are specfied, the following defaults are also provided: - https://www.googleapis.com/auth/bigquery - https://www.googleapis.com/auth/bigtable.admin.table - https://www.googleapis.com/auth/bigtable.data - https://www.googleapis.com/auth/devstorage.full_control",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
+                },
+                "tags": {
+                    "description": "The Google Compute Engine tags to add to all instances.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
+                },
+                "metadata": {
+                    "additionalProperties": {
+                        "type": "string"
+                    },
+                    "description": "The Google Compute Engine metadata entries to add to all instances.",
+                    "type": "object"
                 }
             },
             "type": "object"
         },
         "InstanceGroupConfiguration": {
             "description": "The configuration settings for Google Compute Engine resources in an instance group, such as a master or worker group.",
             "id": "InstanceGroupConfiguration",
             "properties": {
                 "numInstances": {
                     "description": "The number of VM instances in the instance group. For master instance groups, must be set to 1.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "instanceNames": {
                     "description": "The list of instance names. Dataproc derives the names from `cluster_name`, `num_instances`, and the instance group if not set by user (recommended practice is to let Dataproc derive the name).",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "imageUri": {
-                    "description": "[Output-only] The Google Compute Engine image resource used for cluster instances. Inferred from `SoftwareConfiguration.image_version`. Example: `compute.googleapis.com/projects/debian-cloud/global/images/backports-debian-7-wheezy-v20140904`.",
+                    "description": "[Output-only] The Google Compute Engine image resource used for cluster instances. Inferred from `SoftwareConfiguration.image_version`.",
                     "type": "string"
                 },
                 "machineTypeUri": {
-                    "description": "The Google Compute Engine machine type used for cluster instances. Example: `compute.googleapis.com/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`.",
+                    "description": "The Google Compute Engine machine type used for cluster instances. Example: `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`.",
                     "type": "string"
                 },
                 "diskConfiguration": {
                     "$ref": "DiskConfiguration",
                     "description": "Disk option configuration settings."
                 },
                 "isPreemptible": {
                     "description": "Specifies that this instance group contains Preemptible Instances.",
                     "type": "boolean"
                 },
@@ skipping 36 matching lines @@
             },
             "type": "object"
         },
         "SoftwareConfiguration": {
             "description": "Specifies the selection and configuration of software inside the cluster.",
             "id": "SoftwareConfiguration",
             "properties": {
                 "imageVersion": {
                     "description": "[Optional] The version of software inside the cluster. It must match the regular expression `[0-9]+\\.[0-9]+`. If unspecified, it defaults to the latest version (see [Cloud Dataproc Versioning](/dataproc/versioning)).",
                     "type": "string"
+                },
+                "properties": {
+                    "additionalProperties": {
+                        "type": "string"
+                    },
+                    "description": "[Optional] The properties to set on daemon configuration files. Property keys are specified in \"prefix:property\" format, such as \"core:fs.defaultFS\". The following are supported prefixes and their mappings: core - core-site.xml hdfs - hdfs-site.xml mapred - mapred-site.xml yarn - yarn-site.xml hive - hive-site.xml pig - pig.properties spark - spark-defaults.conf",
+                    "type": "object"
                 }
             },
             "type": "object"
         },
         "NodeInitializationAction": {
             "description": "Specifies an executable to run on a fully configured node and a timeout period for executable completion.",
             "id": "NodeInitializationAction",
             "properties": {
                 "executableFile": {
                     "description": "[Required] Google Cloud Storage URI of executable file.",
@@ skipping 31 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Operation": {
             "description": "This resource represents a long-running operation that is the result of a network API call.",
             "id": "Operation",
             "properties": {
                 "name": {
-                    "description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping above, the `name` should have the format of `operations/some/unique/name`.",
+                    "description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.",
                     "type": "string"
                 },
                 "metadata": {
                     "additionalProperties": {
                         "description": "Properties of the object. Contains field @ype with type URL.",
                         "type": "any"
                     },
                     "description": "Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.",
                     "type": "object"
                 },
@@ skipping 621 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "CancelOperationRequest": {
             "description": "The request message for Operations.CancelOperation.",
             "id": "CancelOperationRequest",
             "type": "object"
         },
+        "SetIamPolicyRequest": {
+            "description": "Request message for `SetIamPolicy` method.",
+            "id": "SetIamPolicyRequest",
+            "properties": {
+                "policy": {
+                    "$ref": "Policy",
+                    "description": "REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Cloud Platform services (such as Projects) might reject them."
+                }
+            },
+            "type": "object"
+        },
+        "Policy": {
+            "description": "Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources. A `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. **Example** { \"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\"] } ] } For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam).",
+            "id": "Policy",
+            "properties": {
+                "version": {
+                    "description": "Version of the `Policy`. The default version is 0.",
+                    "format": "int32",
+                    "type": "integer"
+                },
+                "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"
+                    },
+                    "type": "array"
+                },
+                "etag": {
+                    "description": "`etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. If no `etag` is provided in the call to `setIamPolicy`, then the existing policy is overwritten blindly.",
+                    "format": "byte",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
+        "Binding": {
+            "description": "Associates `members` with a `role`.",
+            "id": "Binding",
+            "properties": {
+                "role": {
+                    "description": "Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. Required",
+                    "type": "string"
+                },
+                "members": {
+                    "description": "Specifies the identities requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@gmail.com` or `joe@example.com`. * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: A Google Apps domain name that represents all the users of that domain. For example, `google.com` or `example.com`.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
+                }
+            },
+            "type": "object"
+        },
+        "TestIamPermissionsRequest": {
+            "description": "Request message for `TestIamPermissions` method.",
+            "id": "TestIamPermissionsRequest",
+            "properties": {
+                "permissions": {
+                    "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as '*' or 'storage.*') are not allowed. For more information see IAM Overview.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
+                }
+            },
+            "type": "object"
+        },
+        "TestIamPermissionsResponse": {
+            "description": "Response message for `TestIamPermissions` method.",
+            "id": "TestIamPermissionsResponse",
+            "properties": {
+                "permissions": {
+                    "description": "A subset of `TestPermissionsRequest.permissions` that the caller is allowed.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
+                }
+            },
+            "type": "object"
+        },
+        "DiagnoseClusterResults": {
+            "description": "The location of diagnostic output.",
+            "id": "DiagnoseClusterResults",
+            "properties": {
+                "outputUri": {
+                    "description": "[Output-only] The Google Cloud Storage URI of the diagnostic output. This is a plain text file with a summary of collected diagnostics.",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
+        "ClusterOperationMetadata": {
+            "description": "Metadata describing the operation.",
+            "id": "ClusterOperationMetadata",
+            "properties": {
+                "clusterName": {
+                    "description": "Name of the cluster for the operation.",
+                    "type": "string"
+                },
+                "clusterUuid": {
+                    "description": "Cluster UUId for the operation.",
+                    "type": "string"
+                },
+                "status": {
+                    "$ref": "ClusterOperationStatus",
+                    "description": "[Output-only] Current operation status."
+                },
+                "statusHistory": {
+                    "description": "[Output-only] The previous operation status.",
+                    "items": {
+                        "$ref": "ClusterOperationStatus"
+                    },
+                    "type": "array"
+                },
+                "operationType": {
+                    "description": "[Output-only] The operation type.",
+                    "type": "string"
+                },
+                "description": {
+                    "description": "[Output-only] Short description of operation.",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
+        "ClusterOperationStatus": {
+            "description": "The status of the operation.",
+            "id": "ClusterOperationStatus",
+            "properties": {
+                "state": {
+                    "description": "A message containing the operation state.",
+                    "enum": [
+                        "UNKNOWN",
+                        "PENDING",
+                        "RUNNING",
+                        "DONE"
+                    ],
+                    "type": "string"
+                },
+                "innerState": {
+                    "description": "A message containing the detailed operation state.",
+                    "type": "string"
+                },
+                "details": {
+                    "description": "A message containing any operation metadata details.",
+                    "type": "string"
+                },
+                "stateStartTime": {
+                    "description": "The time this state was entered.",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
         "DiagnoseClusterOutputLocation": {
             "description": "The location where output from diagnostic command can be found.",
             "id": "DiagnoseClusterOutputLocation",
             "properties": {
                 "outputUri": {
                     "description": "[Output-only] The Google Cloud Storage URI of the diagnostic output. This will be a plain text file with summary of collected diagnostics.",
                     "type": "string"
                 }
             },
             "type": "object"
@@ skipping 43 matching lines @@
                 "status": {
                     "$ref": "OperationStatus",
                     "description": "[Output-only] Current operation status."
                 },
                 "statusHistory": {
                     "description": "[Output-only] Previous operation status.",
                     "items": {
                         "$ref": "OperationStatus"
                     },
                     "type": "array"
+                },
+                "operationType": {
+                    "description": "[Output-only] The operation type.",
+                    "type": "string"
+                },
+                "description": {
+                    "description": "[Output-only] Short description of operation.",
+                    "type": "string"
                 }
             },
             "type": "object"
         },
         "OperationStatus": {
             "description": "The status of the operation.",
             "id": "OperationStatus",
             "properties": {
                 "state": {
                     "description": "A message containing the operation state.",
@@ skipping 18 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "",
     "title": "Google Cloud Dataproc API",
     "version": "v1beta1"
 }