Api-roll 42: 2016-11-08

discovery/googleapis_beta/cloudresourcemanager__v1beta1.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"
                 }
             }
         }
     },
     "basePath": "",
     "baseUrl": "https://cloudresourcemanager.googleapis.com/",
     "batchPath": "batch",
     "canonicalName": "Cloud Resource Manager",
     "description": "The Google Cloud Resource Manager API provides methods for creating, reading, and updating project metadata.",
     "discoveryVersion": "v1",
     "documentationLink": "https://cloud.google.com/resource-manager",
-    "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/232vNH0y0gf7PFZjf9ayIsMOF0M\"",
+    "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/LEsmfjb1rYEGIEL137RcSgOD86w\"",
     "icons": {
         "x16": "http://www.google.com/images/icons/product/search-16.gif",
         "x32": "http://www.google.com/images/icons/product/search-32.gif"
     },
     "id": "cloudresourcemanager:v1beta1",
     "kind": "discovery#restDescription",
     "name": "cloudresourcemanager",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
@@ skipping 76 matching lines @@
         }
     },
     "protocol": "rest",
     "resources": {
         "projects": {
             "methods": {
                 "create": {
                     "description": "Creates a Project resource. Initially, the Project resource is owned by its creator exclusively. The creator can later grant permission to others to read or update the Project. Several APIs are activated automatically for the Project, including Google Cloud Storage.",
                     "httpMethod": "POST",
                     "id": "cloudresourcemanager.projects.create",
+                    "parameters": {
+                        "useLegacyStack": {
+                            "description": "A safety hatch to opt out of the new reliable project creation process.",
+                            "location": "query",
+                            "type": "boolean"
+                        }
+                    },
                     "path": "v1beta1/projects",
                     "request": {
                         "$ref": "Project"
                     },
                     "response": {
                         "$ref": "Project"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform"
                     ]
@@ skipping 157 matching lines @@
                 },
                 "getIamPolicy": {
                     "description": "Returns the IAM access control policy for the specified Project. Permission is denied if the policy or the resource does not exist.",
                     "httpMethod": "POST",
                     "id": "cloudresourcemanager.projects.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.",
+                            "description": "REQUIRED: The resource for which the policy is being requested. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "v1beta1/projects/{resource}:getIamPolicy",
                     "request": {
                         "$ref": "GetIamPolicyRequest"
                     },
                     "response": {
                         "$ref": "Policy"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/cloud-platform.read-only"
                     ]
                 },
                 "setIamPolicy": {
-                    "description": "Sets the IAM access control policy for the specified Project. Replaces any existing policy. The following constraints apply when using `setIamPolicy()`: + Project does not support `allUsers` and `allAuthenticatedUsers` as `members` in a `Binding` of a `Policy`. + The owner role can be granted only to `user` and `serviceAccount`. + Service accounts can be made owners of a project directly without any restrictions. However, to be added as an owner, a user must be invited via Cloud Platform console and must accept the invitation. + A user cannot be granted the owner role using `setIamPolicy()`. The user must be granted the owner role using the Cloud Platform Console and must explicitly accept the invitation. + Invitations to grant the owner role cannot be sent using `setIamPolicy()`; they must be sent only using the Cloud Platform Console. + Membership changes that leave the project without any owners that have accepted the Terms of Service (ToS) will be rejected. + Members cannot be added to more than one role in the same policy. + There must be at least one owner who has accepted the Terms of Service (ToS) agreement in the policy. Calling `setIamPolicy()` to to remove the last ToS-accepted owner from the policy will fail. This restriction also applies to legacy projects that no longer have owners who have accepted the ToS. Edits to IAM policies will be rejected until the lack of a ToS-accepting owner is rectified. + Calling this method requires enabling the App Engine Admin API. Note: Removing service accounts from policies or changing their roles can render services completely inoperable. It is important to understand how the service account is being used before removing or updating its roles.",
+                    "description": "Sets the IAM access control policy for the specified Project. Replaces any existing policy. The following constraints apply when using `setIamPolicy()`: + Project does not support `allUsers` and `allAuthenticatedUsers` as `members` in a `Binding` of a `Policy`. + The owner role can be granted only to `user` and `serviceAccount`. + Service accounts can be made owners of a project directly without any restrictions. However, to be added as an owner, a user must be invited via Cloud Platform console and must accept the invitation. + A user cannot be granted the owner role using `setIamPolicy()`. The user must be granted the owner role using the Cloud Platform Console and must explicitly accept the invitation. + Invitations to grant the owner role cannot be sent using `setIamPolicy()`; they must be sent only using the Cloud Platform Console. + Membership changes that leave the project without any owners that have accepted the Terms of Service (ToS) will be rejected. + There must be at least one owner who has accepted the Terms of Service (ToS) agreement in the policy. Calling `setIamPolicy()` to to remove the last ToS-accepted owner from the policy will fail. This restriction also applies to legacy projects that no longer have owners who have accepted the ToS. Edits to IAM policies will be rejected until the lack of a ToS-accepting owner is rectified. + Calling this method requires enabling the App Engine Admin API. Note: Removing service accounts from policies or changing their roles can render services completely inoperable. It is important to understand how the service account is being used before removing or updating its roles.",
                     "httpMethod": "POST",
                     "id": "cloudresourcemanager.projects.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.",
+                            "description": "REQUIRED: The resource for which the policy is being specified. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "v1beta1/projects/{resource}:setIamPolicy",
                     "request": {
                         "$ref": "SetIamPolicyRequest"
                     },
                     "response": {
                         "$ref": "Policy"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform"
                     ]
                 },
                 "testIamPermissions": {
                     "description": "Returns permissions that a caller has on the specified Project.",
                     "httpMethod": "POST",
                     "id": "cloudresourcemanager.projects.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.",
+                            "description": "REQUIRED: The resource for which the policy detail is being requested. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "v1beta1/projects/{resource}:testIamPermissions",
                     "request": {
                         "$ref": "TestIamPermissionsRequest"
                     },
                     "response": {
@@ skipping 41 matching lines @@
                 },
                 "get": {
                     "description": "Fetches an Organization resource identified by the specified resource name.",
                     "httpMethod": "GET",
                     "id": "cloudresourcemanager.organizations.get",
                     "parameterOrder": [
                         "name"
                     ],
                     "parameters": {
                         "name": {
-                            "description": "The resource name of the Organization to fetch. Its format is \"organizations/[organization_id]\". For example, \"organizations/1234\".",
+                            "description": "The resource name of the Organization to fetch, e.g. \"organizations/1234\".",
                             "location": "path",
                             "pattern": "^organizations/[^/]*$",
                             "required": true,
                             "type": "string"
                         },
                         "organizationId": {
                             "description": "The id of the Organization resource to fetch. This field is deprecated and will be removed in v1. Use name instead.",
                             "location": "query",
                             "type": "string"
                         }
@@ skipping 28 matching lines @@
                         "$ref": "Organization"
                     },
                     "response": {
                         "$ref": "Organization"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform"
                     ]
                 },
                 "setIamPolicy": {
-                    "description": "Sets the access control policy on an Organization resource. Replaces any existing policy. The `resource` field should be the organization's resource name, e.g. \"organizations/123\". For backward compatibility, the resource provided may also be the organization_id. This will not be supported in v1.",
+                    "description": "Sets the access control policy on an Organization resource. Replaces any existing policy. The `resource` field should be the organization's resource name, e.g. \"organizations/123\".",
                     "httpMethod": "POST",
                     "id": "cloudresourcemanager.organizations.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.",
+                            "description": "REQUIRED: The resource for which the policy is being specified. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`.",
                             "location": "path",
                             "pattern": "^organizations/[^/]*$",
                             "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 an Organization resource. May be empty if no such policy or resource exists. The `resource` field should be the organization's resource name, e.g. \"organizations/123\". For backward compatibility, the resource provided may also be the organization_id. This will not be supported in v1.",
+                    "description": "Gets the access control policy for an Organization resource. May be empty if no such policy or resource exists. The `resource` field should be the organization's resource name, e.g. \"organizations/123\".",
                     "httpMethod": "POST",
                     "id": "cloudresourcemanager.organizations.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.",
+                            "description": "REQUIRED: The resource for which the policy is being requested. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`.",
                             "location": "path",
                             "pattern": "^organizations/[^/]*$",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "v1beta1/{+resource}:getIamPolicy",
                     "request": {
                         "$ref": "GetIamPolicyRequest"
                     },
                     "response": {
                         "$ref": "Policy"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/cloud-platform.read-only"
                     ]
                 },
                 "testIamPermissions": {
-                    "description": "Returns permissions that a caller has on the specified Organization. The `resource` field should be the organization's resource name, e.g. \"organizations/123\". For backward compatibility, the resource provided may also be the organization_id. This will not be supported in v1.",
+                    "description": "Returns permissions that a caller has on the specified Organization. The `resource` field should be the organization's resource name, e.g. \"organizations/123\".",
                     "httpMethod": "POST",
                     "id": "cloudresourcemanager.organizations.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.",
+                            "description": "REQUIRED: The resource for which the policy detail is being requested. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`.",
                             "location": "path",
                             "pattern": "^organizations/[^/]*$",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "v1beta1/{+resource}:testIamPermissions",
                     "request": {
                         "$ref": "TestIamPermissionsRequest"
                     },
                     "response": {
                         "$ref": "TestIamPermissionsResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/cloud-platform.read-only"
                     ]
                 }
             }
         }
     },
-    "revision": "20160617",
+    "revision": "20160927",
     "rootUrl": "https://cloudresourcemanager.googleapis.com/",
     "schemas": {
         "Project": {
             "description": "A Project is a high-level Google Cloud Platform entity. It is a container for ACLs, APIs, AppEngine Apps, VMs, and other Google Cloud Platform resources.",
             "id": "Project",
             "properties": {
                 "projectNumber": {
                     "description": "The number uniquely identifying the project. Example: 415104041262 Read-only.",
                     "format": "int64",
                     "type": "string"
@@ skipping 163 matching lines @@
                     "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"
         },
         "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.",
+                    "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](https://cloud.google.com/iam/docs/overview#permissions).",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "TestIamPermissionsResponse": {
             "description": "Response message for `TestIamPermissions` method.",
@@ skipping 33 matching lines @@
             "properties": {
                 "name": {
                     "description": "Output Only. The resource name of the organization. This is the organization's relative path in the API. Its format is \"organizations/[organization_id]\". For example, \"organizations/1234\".",
                     "type": "string"
                 },
                 "organizationId": {
                     "description": "An immutable id for the Organization that is assigned on creation. This should be omitted when creating a new Organization. This field is read-only. This field is deprecated and will be removed in v1. Use name instead.",
                     "type": "string"
                 },
                 "displayName": {
-                    "description": "A friendly string to be used to refer to the Organization in the UI. This field is required.",
+                    "description": "A friendly string to be used to refer to the Organization in the UI. Assigned by the server, set to the firm name of the Google For Work customer that owns this organization. @OutputOnly",
                     "type": "string"
                 },
                 "owner": {
                     "$ref": "OrganizationOwner",
                     "description": "The owner of this Organization. The owner should be specified on creation. Once set, it cannot be changed. This field is required."
                 },
                 "creationTime": {
                     "description": "Timestamp when the Organization was created. Assigned by the server. @OutputOnly",
                     "type": "string"
                 },
@@ skipping 12 matching lines @@
         "OrganizationOwner": {
             "description": "The entity that owns an Organization. The lifetime of the Organization and all of its descendants are bound to the `OrganizationOwner`. If the `OrganizationOwner` is deleted, the Organization and all its descendants will be deleted.",
             "id": "OrganizationOwner",
             "properties": {
                 "directoryCustomerId": {
                     "description": "The Google for Work customer id used in the Directory API.",
                     "type": "string"
                 }
             },
             "type": "object"
+        },
+        "ProjectCreationStatus": {
+            "description": "A status object which is used as the `metadata` field for the Operation returned by CreateProject. It provides insight for when significant phases of Project creation have completed.",
+            "id": "ProjectCreationStatus",
+            "properties": {
+                "createTime": {
+                    "description": "Creation time of the project creation workflow.",
+                    "type": "string"
+                },
+                "gettable": {
+                    "description": "True if the project can be retrieved using GetProject. No other operations on the project are guaranteed to work until the project creation is complete.",
+                    "type": "boolean"
+                },
+                "ready": {
+                    "description": "True if the project creation process is complete.",
+                    "type": "boolean"
+                }
+            },
+            "type": "object"
+        },
+        "FolderOperation": {
+            "description": "Metadata describing a long running folder operation",
+            "id": "FolderOperation",
+            "properties": {
+                "displayName": {
+                    "description": "The display name of the folder.",
+                    "type": "string"
+                },
+                "operationType": {
+                    "description": "The type of this operation.",
+                    "enum": [
+                        "OPERATION_TYPE_UNSPECIFIED",
+                        "CREATE",
+                        "MOVE"
+                    ],
+                    "type": "string"
+                },
+                "sourceParent": {
+                    "description": "The resource name of the folder's parent. Only applicable when the operation_type is MOVE.",
+                    "type": "string"
+                },
+                "destinationParent": {
+                    "description": "The resource name of the folder or organization we are either creating the folder under or moving the folder to.",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
+        "FolderOperationError": {
+            "description": "A classification of the Folder Operation error.",
+            "id": "FolderOperationError",
+            "properties": {
+                "errorMessageId": {
+                    "description": "The type of operation error experienced.",
+                    "enum": [
+                        "ERROR_TYPE_UNSPECIFIED",
+                        "FOLDER_HEIGHT_VIOLATION",
+                        "MAX_CHILD_FOLDERS_VIOLATION",
+                        "FOLDER_NAME_UNIQUENESS_VIOLATION",
+                        "RESOURCE_DELETED",
+                        "PARENT_DELETED",
+                        "CYCLE_INTRODUCED_ERROR",
+                        "FOLDER_ALREADY_BEING_MOVED",
+                        "FOLDER_TO_DELETE_NON_EMPTY"
+                    ],
+                    "type": "string"
+                }
+            },
+            "type": "object"
         }
     },
     "servicePath": "",
     "title": "Google Cloud Resource Manager API",
     "version": "v1beta1"
 }