| Index: tools/telemetry/third_party/gsutilz/gslib/addlhelp/projects.py
|
| diff --git a/tools/telemetry/third_party/gsutilz/gslib/addlhelp/projects.py b/tools/telemetry/third_party/gsutilz/gslib/addlhelp/projects.py
|
| deleted file mode 100644
|
| index 2eb7b78a0a9f5e0d6c9cafbb4275311e86628127..0000000000000000000000000000000000000000
|
| --- a/tools/telemetry/third_party/gsutilz/gslib/addlhelp/projects.py
|
| +++ /dev/null
|
| @@ -1,103 +0,0 @@
|
| -# -*- coding: utf-8 -*-
|
| -# Copyright 2012 Google Inc. All Rights Reserved.
|
| -#
|
| -# Licensed under the Apache License, Version 2.0 (the "License");
|
| -# you may not use this file except in compliance with the License.
|
| -# You may obtain a copy of the License at
|
| -#
|
| -# http://www.apache.org/licenses/LICENSE-2.0
|
| -#
|
| -# Unless required by applicable law or agreed to in writing, software
|
| -# distributed under the License is distributed on an "AS IS" BASIS,
|
| -# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
| -# See the License for the specific language governing permissions and
|
| -# limitations under the License.
|
| -"""Additional help about Google Cloud Storage projects."""
|
| -
|
| -from __future__ import absolute_import
|
| -
|
| -from gslib.help_provider import HelpProvider
|
| -
|
| -_DETAILED_HELP_TEXT = ("""
|
| -<B>OVERVIEW</B>
|
| - This section discusses how to work with projects in Google Cloud Storage.
|
| -
|
| -
|
| -<B>PROJECT MEMBERS AND PERMISSIONS</B>
|
| - There are three groups of users associated with each project:
|
| -
|
| - - Project Owners are allowed to list, create, and delete buckets,
|
| - and can also perform administrative tasks like adding and removing team
|
| - members and changing billing. The project owners group is the owner
|
| - of all buckets within a project, regardless of who may be the original
|
| - bucket creator.
|
| -
|
| - - Project Editors are allowed to list, create, and delete buckets.
|
| -
|
| - - All Project Team Members are allowed to list buckets within a project.
|
| -
|
| - These projects make it easy to set up a bucket and start uploading objects
|
| - with access control appropriate for a project at your company, as the three
|
| - group memberships can be configured by your administrative staff. Control
|
| - over projects and their associated memberships is provided by the
|
| - `Google Developers Console <https://cloud.google.com/console#/project>`_.
|
| -
|
| -
|
| -<B>HOW PROJECT MEMBERSHIP IS REFLECTED IN BUCKET ACLS</B>
|
| - When you create a bucket without specifying an ACL the bucket is given a
|
| - "project-private" ACL, which grants the permissions described in the previous
|
| - section. Here's an example of such an ACL:
|
| -
|
| - [
|
| - {
|
| - "entity": "group-00b4903a9740e42c29800f53bd5a9a62a2f96eb3f64a4313a115df3f3a776bf7",
|
| - "entityId": "00b4903a9740e42c29800f53bd5a9a62a2f96eb3f64a4313a115df3f3a776bf7",
|
| - "role": "OWNER"
|
| - },
|
| - {
|
| - "entity": "group-00b4903a977fd817e9da167bc81306489181a110456bb635f466d71cf90a0d51",
|
| - "entityId": "00b4903a977fd817e9da167bc81306489181a110456bb635f466d71cf90a0d51",
|
| - "role": "OWNER"
|
| - },
|
| - {
|
| - "entity": "00b4903a974898cc8fc309f2f2835308ba3d3df1b889d3fc7e33e187d52d8e71",
|
| - "entityId": "00b4903a974898cc8fc309f2f2835308ba3d3df1b889d3fc7e33e187d52d8e71",
|
| - "role": "READER"
|
| - }
|
| - ]
|
| -
|
| - The three "entityId"s are the canonical IDs for the Project Owners,
|
| - Project Editors, and All Project Team Members groups.
|
| -
|
| - You can edit the bucket ACL if you want to (see "gsutil help acl"),
|
| - but for many cases you'll never need to, and instead can change group
|
| - membership via the
|
| - `Google Developers Console <https://cloud.google.com/console#/project>`_.
|
| -
|
| -
|
| -<B>IDENTIFYING PROJECTS WHEN CREATING AND LISTING BUCKETS</B>
|
| - When you create a bucket or list your buckets, you need to provide the
|
| - project ID that you want to create or list (using the gsutil mb -p option or
|
| - the gsutil ls -p option, respectively). The project's name shown in the
|
| - Google Developers Console is a user-friendly name that you can choose; this is
|
| - not the project ID required by the gsutil mb and ls commands. To find the
|
| - project ID, go to the Cloud Storage pane in the Google Developers Console.
|
| - The project ID is listed as "Project Number" in the Overview pane of your
|
| - project.
|
| -""")
|
| -
|
| -
|
| -class CommandOptions(HelpProvider):
|
| - """Additional help about Google Cloud Storage projects."""
|
| -
|
| - # Help specification. See help_provider.py for documentation.
|
| - help_spec = HelpProvider.HelpSpec(
|
| - help_name='projects',
|
| - help_name_aliases=[
|
| - 'apis console', 'cloud console', 'console', 'dev console', 'project',
|
| - 'proj', 'project-id'],
|
| - help_type='additional_help',
|
| - help_one_line_summary='Working With Projects',
|
| - help_text=_DETAILED_HELP_TEXT,
|
| - subcommand_help_text={},
|
| - )
|
|
|