Index: discovery/googleapis_beta/cloudresourcemanager__v1beta1.json |
diff --git a/discovery/googleapis_beta/cloudresourcemanager__v1beta1.json b/discovery/googleapis_beta/cloudresourcemanager__v1beta1.json |
index d409b76efa977f42e854fb05039176c7bcf926c5..96b291218e00b0b3d1eb1f20f00d1b1fcdcfacec 100644 |
--- a/discovery/googleapis_beta/cloudresourcemanager__v1beta1.json |
+++ b/discovery/googleapis_beta/cloudresourcemanager__v1beta1.json |
@@ -18,7 +18,7 @@ |
"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" |
@@ -115,6 +115,13 @@ |
"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" |
@@ -292,7 +299,7 @@ |
], |
"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" |
@@ -311,7 +318,7 @@ |
] |
}, |
"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": [ |
@@ -319,7 +326,7 @@ |
], |
"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" |
@@ -345,7 +352,7 @@ |
], |
"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" |
@@ -407,7 +414,7 @@ |
], |
"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, |
@@ -456,7 +463,7 @@ |
] |
}, |
"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": [ |
@@ -464,7 +471,7 @@ |
], |
"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, |
@@ -483,7 +490,7 @@ |
] |
}, |
"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": [ |
@@ -491,7 +498,7 @@ |
], |
"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, |
@@ -511,7 +518,7 @@ |
] |
}, |
"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": [ |
@@ -519,7 +526,7 @@ |
], |
"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, |
@@ -541,7 +548,7 @@ |
} |
} |
}, |
- "revision": "20160617", |
+ "revision": "20160927", |
"rootUrl": "https://cloudresourcemanager.googleapis.com/", |
"schemas": { |
"Project": { |
@@ -725,7 +732,7 @@ |
"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" |
}, |
@@ -779,7 +786,7 @@ |
"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": { |
@@ -812,6 +819,75 @@ |
} |
}, |
"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": "", |