Home | History | Annotate | Download | only in dyn
      1 <html><body>
      2 <style>
      3 
      4 body, h1, h2, h3, div, span, p, pre, a {
      5   margin: 0;
      6   padding: 0;
      7   border: 0;
      8   font-weight: inherit;
      9   font-style: inherit;
     10   font-size: 100%;
     11   font-family: inherit;
     12   vertical-align: baseline;
     13 }
     14 
     15 body {
     16   font-size: 13px;
     17   padding: 1em;
     18 }
     19 
     20 h1 {
     21   font-size: 26px;
     22   margin-bottom: 1em;
     23 }
     24 
     25 h2 {
     26   font-size: 24px;
     27   margin-bottom: 1em;
     28 }
     29 
     30 h3 {
     31   font-size: 20px;
     32   margin-bottom: 1em;
     33   margin-top: 1em;
     34 }
     35 
     36 pre, code {
     37   line-height: 1.5;
     38   font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
     39 }
     40 
     41 pre {
     42   margin-top: 0.5em;
     43 }
     44 
     45 h1, h2, h3, p {
     46   font-family: Arial, sans serif;
     47 }
     48 
     49 h1, h2, h3 {
     50   border-bottom: solid #CCC 1px;
     51 }
     52 
     53 .toc_element {
     54   margin-top: 0.5em;
     55 }
     56 
     57 .firstline {
     58   margin-left: 2 em;
     59 }
     60 
     61 .method  {
     62   margin-top: 1em;
     63   border: solid 1px #CCC;
     64   padding: 1em;
     65   background: #EEE;
     66 }
     67 
     68 .details {
     69   font-weight: bold;
     70   font-size: 14px;
     71 }
     72 
     73 </style>
     74 
     75 <h1><a href="cloudresourcemanager_v1beta1.html">Google Cloud Resource Manager API</a> . <a href="cloudresourcemanager_v1beta1.projects.html">projects</a></h1>
     76 <h2>Instance Methods</h2>
     77 <p class="toc_element">
     78   <code><a href="#create">create(body, useLegacyStack=None, x__xgafv=None)</a></code></p>
     79 <p class="firstline">Creates a Project resource.</p>
     80 <p class="toc_element">
     81   <code><a href="#delete">delete(projectId, x__xgafv=None)</a></code></p>
     82 <p class="firstline">Marks the Project identified by the specified</p>
     83 <p class="toc_element">
     84   <code><a href="#get">get(projectId, x__xgafv=None)</a></code></p>
     85 <p class="firstline">Retrieves the Project identified by the specified</p>
     86 <p class="toc_element">
     87   <code><a href="#getAncestry">getAncestry(projectId, body, x__xgafv=None)</a></code></p>
     88 <p class="firstline">Gets a list of ancestors in the resource hierarchy for the Project</p>
     89 <p class="toc_element">
     90   <code><a href="#getIamPolicy">getIamPolicy(resource, body, x__xgafv=None)</a></code></p>
     91 <p class="firstline">Returns the IAM access control policy for the specified Project.</p>
     92 <p class="toc_element">
     93   <code><a href="#list">list(pageSize=None, filter=None, pageToken=None, x__xgafv=None)</a></code></p>
     94 <p class="firstline">Lists Projects that are visible to the user and satisfy the</p>
     95 <p class="toc_element">
     96   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
     97 <p class="firstline">Retrieves the next page of results.</p>
     98 <p class="toc_element">
     99   <code><a href="#setIamPolicy">setIamPolicy(resource, body, x__xgafv=None)</a></code></p>
    100 <p class="firstline">Sets the IAM access control policy for the specified Project. Replaces</p>
    101 <p class="toc_element">
    102   <code><a href="#testIamPermissions">testIamPermissions(resource, body, x__xgafv=None)</a></code></p>
    103 <p class="firstline">Returns permissions that a caller has on the specified Project.</p>
    104 <p class="toc_element">
    105   <code><a href="#undelete">undelete(projectId, body, x__xgafv=None)</a></code></p>
    106 <p class="firstline">Restores the Project identified by the specified</p>
    107 <p class="toc_element">
    108   <code><a href="#update">update(projectId, body, x__xgafv=None)</a></code></p>
    109 <p class="firstline">Updates the attributes of the Project identified by the specified</p>
    110 <h3>Method Details</h3>
    111 <div class="method">
    112     <code class="details" id="create">create(body, useLegacyStack=None, x__xgafv=None)</code>
    113   <pre>Creates a Project resource.
    114 
    115 Initially, the Project resource is owned by its creator exclusively.
    116 The creator can later grant permission to others to read or update the
    117 Project.
    118 
    119 Several APIs are activated automatically for the Project, including
    120 Google Cloud Storage.
    121 
    122 Args:
    123   body: object, The request body. (required)
    124     The object takes the form of:
    125 
    126 { # A Project is a high-level Google Cloud Platform entity.  It is a
    127     # container for ACLs, APIs, App Engine Apps, VMs, and other
    128     # Google Cloud Platform resources.
    129   "name": "A String", # The user-assigned display name of the Project.
    130       # It must be 4 to 30 characters.
    131       # Allowed characters are: lowercase and uppercase letters, numbers,
    132       # hyphen, single-quote, double-quote, space, and exclamation point.
    133       # 
    134       # Example: <code>My Project</code>
    135       # Read-write.
    136   "parent": { # A container to reference an id for any resource type. A `resource` in Google # An optional reference to a parent Resource.
    137       # 
    138       # The only supported parent type is "organization". Once set, the parent
    139       # cannot be modified. The `parent` can be set on creation or using the
    140       # `UpdateProject` method; the end user must have the
    141       # `resourcemanager.projects.create` permission on the parent.
    142       # 
    143       # Read-write.
    144       # Cloud Platform is a generic term for something you (a developer) may want to
    145       # interact with through one of our API's. Some examples are an App Engine app,
    146       # a Compute Engine instance, a Cloud SQL database, and so on.
    147     "type": "A String", # Required field representing the resource type this id is for.
    148         # At present, the valid types are "project" and "organization".
    149     "id": "A String", # Required field for the type-specific id. This should correspond to the id
    150         # used in the type-specific API's.
    151   },
    152   "projectId": "A String", # The unique, user-assigned ID of the Project.
    153       # It must be 6 to 30 lowercase letters, digits, or hyphens.
    154       # It must start with a letter.
    155       # Trailing hyphens are prohibited.
    156       # 
    157       # Example: <code>tokyo-rain-123</code>
    158       # Read-only after creation.
    159   "labels": { # The labels associated with this Project.
    160       # 
    161       # Label keys must be between 1 and 63 characters long and must conform
    162       # to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?.
    163       # 
    164       # Label values must be between 0 and 63 characters long and must conform
    165       # to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
    166       # 
    167       # No more than 256 labels can be associated with a given resource.
    168       # 
    169       # Clients should store labels in a representation such as JSON that does not
    170       # depend on specific characters being disallowed.
    171       # 
    172       # Example: <code>"environment" : "dev"</code>
    173       # Read-write.
    174     "a_key": "A String",
    175   },
    176   "projectNumber": "A String", # The number uniquely identifying the project.
    177       # 
    178       # Example: <code>415104041262</code>
    179       # Read-only.
    180   "lifecycleState": "A String", # The Project lifecycle state.
    181       # 
    182       # Read-only.
    183   "createTime": "A String", # Creation time.
    184       # 
    185       # Read-only.
    186 }
    187 
    188   useLegacyStack: boolean, A safety hatch to opt out of the new reliable project creation process.
    189   x__xgafv: string, V1 error format.
    190     Allowed values
    191       1 - v1 error format
    192       2 - v2 error format
    193 
    194 Returns:
    195   An object of the form:
    196 
    197     { # A Project is a high-level Google Cloud Platform entity.  It is a
    198       # container for ACLs, APIs, App Engine Apps, VMs, and other
    199       # Google Cloud Platform resources.
    200     "name": "A String", # The user-assigned display name of the Project.
    201         # It must be 4 to 30 characters.
    202         # Allowed characters are: lowercase and uppercase letters, numbers,
    203         # hyphen, single-quote, double-quote, space, and exclamation point.
    204         #
    205         # Example: <code>My Project</code>
    206         # Read-write.
    207     "parent": { # A container to reference an id for any resource type. A `resource` in Google # An optional reference to a parent Resource.
    208         #
    209         # The only supported parent type is "organization". Once set, the parent
    210         # cannot be modified. The `parent` can be set on creation or using the
    211         # `UpdateProject` method; the end user must have the
    212         # `resourcemanager.projects.create` permission on the parent.
    213         #
    214         # Read-write.
    215         # Cloud Platform is a generic term for something you (a developer) may want to
    216         # interact with through one of our API's. Some examples are an App Engine app,
    217         # a Compute Engine instance, a Cloud SQL database, and so on.
    218       "type": "A String", # Required field representing the resource type this id is for.
    219           # At present, the valid types are "project" and "organization".
    220       "id": "A String", # Required field for the type-specific id. This should correspond to the id
    221           # used in the type-specific API's.
    222     },
    223     "projectId": "A String", # The unique, user-assigned ID of the Project.
    224         # It must be 6 to 30 lowercase letters, digits, or hyphens.
    225         # It must start with a letter.
    226         # Trailing hyphens are prohibited.
    227         #
    228         # Example: <code>tokyo-rain-123</code>
    229         # Read-only after creation.
    230     "labels": { # The labels associated with this Project.
    231         #
    232         # Label keys must be between 1 and 63 characters long and must conform
    233         # to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?.
    234         #
    235         # Label values must be between 0 and 63 characters long and must conform
    236         # to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
    237         #
    238         # No more than 256 labels can be associated with a given resource.
    239         #
    240         # Clients should store labels in a representation such as JSON that does not
    241         # depend on specific characters being disallowed.
    242         #
    243         # Example: <code>"environment" : "dev"</code>
    244         # Read-write.
    245       "a_key": "A String",
    246     },
    247     "projectNumber": "A String", # The number uniquely identifying the project.
    248         #
    249         # Example: <code>415104041262</code>
    250         # Read-only.
    251     "lifecycleState": "A String", # The Project lifecycle state.
    252         #
    253         # Read-only.
    254     "createTime": "A String", # Creation time.
    255         #
    256         # Read-only.
    257   }</pre>
    258 </div>
    259 
    260 <div class="method">
    261     <code class="details" id="delete">delete(projectId, x__xgafv=None)</code>
    262   <pre>Marks the Project identified by the specified
    263 `project_id` (for example, `my-project-123`) for deletion.
    264 This method will only affect the Project if the following criteria are met:
    265 
    266 + The Project does not have a billing account associated with it.
    267 + The Project has a lifecycle state of
    268 ACTIVE.
    269 
    270 This method changes the Project's lifecycle state from
    271 ACTIVE
    272 to DELETE_REQUESTED.
    273 The deletion starts at an unspecified time, at which point the project is
    274 no longer accessible.
    275 
    276 Until the deletion completes, you can check the lifecycle state
    277 checked by retrieving the Project with GetProject,
    278 and the Project remains visible to ListProjects.
    279 However, you cannot update the project.
    280 
    281 After the deletion completes, the Project is not retrievable by
    282 the  GetProject and
    283 ListProjects methods.
    284 
    285 The caller must have modify permissions for this Project.
    286 
    287 Args:
    288   projectId: string, The Project ID (for example, `foo-bar-123`).
    289 
    290 Required. (required)
    291   x__xgafv: string, V1 error format.
    292     Allowed values
    293       1 - v1 error format
    294       2 - v2 error format
    295 
    296 Returns:
    297   An object of the form:
    298 
    299     { # A generic empty message that you can re-use to avoid defining duplicated
    300       # empty messages in your APIs. A typical example is to use it as the request
    301       # or the response type of an API method. For instance:
    302       #
    303       #     service Foo {
    304       #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
    305       #     }
    306       #
    307       # The JSON representation for `Empty` is empty JSON object `{}`.
    308   }</pre>
    309 </div>
    310 
    311 <div class="method">
    312     <code class="details" id="get">get(projectId, x__xgafv=None)</code>
    313   <pre>Retrieves the Project identified by the specified
    314 `project_id` (for example, `my-project-123`).
    315 
    316 The caller must have read permissions for this Project.
    317 
    318 Args:
    319   projectId: string, The Project ID (for example, `my-project-123`).
    320 
    321 Required. (required)
    322   x__xgafv: string, V1 error format.
    323     Allowed values
    324       1 - v1 error format
    325       2 - v2 error format
    326 
    327 Returns:
    328   An object of the form:
    329 
    330     { # A Project is a high-level Google Cloud Platform entity.  It is a
    331       # container for ACLs, APIs, App Engine Apps, VMs, and other
    332       # Google Cloud Platform resources.
    333     "name": "A String", # The user-assigned display name of the Project.
    334         # It must be 4 to 30 characters.
    335         # Allowed characters are: lowercase and uppercase letters, numbers,
    336         # hyphen, single-quote, double-quote, space, and exclamation point.
    337         #
    338         # Example: <code>My Project</code>
    339         # Read-write.
    340     "parent": { # A container to reference an id for any resource type. A `resource` in Google # An optional reference to a parent Resource.
    341         #
    342         # The only supported parent type is "organization". Once set, the parent
    343         # cannot be modified. The `parent` can be set on creation or using the
    344         # `UpdateProject` method; the end user must have the
    345         # `resourcemanager.projects.create` permission on the parent.
    346         #
    347         # Read-write.
    348         # Cloud Platform is a generic term for something you (a developer) may want to
    349         # interact with through one of our API's. Some examples are an App Engine app,
    350         # a Compute Engine instance, a Cloud SQL database, and so on.
    351       "type": "A String", # Required field representing the resource type this id is for.
    352           # At present, the valid types are "project" and "organization".
    353       "id": "A String", # Required field for the type-specific id. This should correspond to the id
    354           # used in the type-specific API's.
    355     },
    356     "projectId": "A String", # The unique, user-assigned ID of the Project.
    357         # It must be 6 to 30 lowercase letters, digits, or hyphens.
    358         # It must start with a letter.
    359         # Trailing hyphens are prohibited.
    360         #
    361         # Example: <code>tokyo-rain-123</code>
    362         # Read-only after creation.
    363     "labels": { # The labels associated with this Project.
    364         #
    365         # Label keys must be between 1 and 63 characters long and must conform
    366         # to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?.
    367         #
    368         # Label values must be between 0 and 63 characters long and must conform
    369         # to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
    370         #
    371         # No more than 256 labels can be associated with a given resource.
    372         #
    373         # Clients should store labels in a representation such as JSON that does not
    374         # depend on specific characters being disallowed.
    375         #
    376         # Example: <code>"environment" : "dev"</code>
    377         # Read-write.
    378       "a_key": "A String",
    379     },
    380     "projectNumber": "A String", # The number uniquely identifying the project.
    381         #
    382         # Example: <code>415104041262</code>
    383         # Read-only.
    384     "lifecycleState": "A String", # The Project lifecycle state.
    385         #
    386         # Read-only.
    387     "createTime": "A String", # Creation time.
    388         #
    389         # Read-only.
    390   }</pre>
    391 </div>
    392 
    393 <div class="method">
    394     <code class="details" id="getAncestry">getAncestry(projectId, body, x__xgafv=None)</code>
    395   <pre>Gets a list of ancestors in the resource hierarchy for the Project
    396 identified by the specified `project_id` (for example, `my-project-123`).
    397 
    398 The caller must have read permissions for this Project.
    399 
    400 Args:
    401   projectId: string, The Project ID (for example, `my-project-123`).
    402 
    403 Required. (required)
    404   body: object, The request body. (required)
    405     The object takes the form of:
    406 
    407 { # The request sent to the
    408       # GetAncestry
    409       # method.
    410   }
    411 
    412   x__xgafv: string, V1 error format.
    413     Allowed values
    414       1 - v1 error format
    415       2 - v2 error format
    416 
    417 Returns:
    418   An object of the form:
    419 
    420     { # Response from the GetAncestry method.
    421     "ancestor": [ # Ancestors are ordered from bottom to top of the resource hierarchy. The
    422         # first ancestor is the project itself, followed by the project's parent,
    423         # etc.
    424       { # Identifying information for a single ancestor of a project.
    425         "resourceId": { # A container to reference an id for any resource type. A `resource` in Google # Resource id of the ancestor.
    426             # Cloud Platform is a generic term for something you (a developer) may want to
    427             # interact with through one of our API's. Some examples are an App Engine app,
    428             # a Compute Engine instance, a Cloud SQL database, and so on.
    429           "type": "A String", # Required field representing the resource type this id is for.
    430               # At present, the valid types are "project" and "organization".
    431           "id": "A String", # Required field for the type-specific id. This should correspond to the id
    432               # used in the type-specific API's.
    433         },
    434       },
    435     ],
    436   }</pre>
    437 </div>
    438 
    439 <div class="method">
    440     <code class="details" id="getIamPolicy">getIamPolicy(resource, body, x__xgafv=None)</code>
    441   <pre>Returns the IAM access control policy for the specified Project.
    442 Permission is denied if the policy or the resource does not exist.
    443 
    444 Args:
    445   resource: string, REQUIRED: The resource for which the policy is being requested.
    446 See the operation documentation for the appropriate value for this field. (required)
    447   body: object, The request body. (required)
    448     The object takes the form of:
    449 
    450 { # Request message for `GetIamPolicy` method.
    451   }
    452 
    453   x__xgafv: string, V1 error format.
    454     Allowed values
    455       1 - v1 error format
    456       2 - v2 error format
    457 
    458 Returns:
    459   An object of the form:
    460 
    461     { # Defines an Identity and Access Management (IAM) policy. It is used to
    462       # specify access control policies for Cloud Platform resources.
    463       #
    464       #
    465       # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
    466       # `members` to a `role`, where the members can be user accounts, Google groups,
    467       # Google domains, and service accounts. A `role` is a named list of permissions
    468       # defined by IAM.
    469       #
    470       # **Example**
    471       #
    472       #     {
    473       #       "bindings": [
    474       #         {
    475       #           "role": "roles/owner",
    476       #           "members": [
    477       #             "user:mike (a] example.com",
    478       #             "group:admins (a] example.com",
    479       #             "domain:google.com",
    480       #             "serviceAccount:my-other-app (a] appspot.gserviceaccount.com",
    481       #           ]
    482       #         },
    483       #         {
    484       #           "role": "roles/viewer",
    485       #           "members": ["user:sean (a] example.com"]
    486       #         }
    487       #       ]
    488       #     }
    489       #
    490       # For a description of IAM and its features, see the
    491       # [IAM developer's guide](https://cloud.google.com/iam).
    492     "bindings": [ # Associates a list of `members` to a `role`.
    493         # Multiple `bindings` must not be specified for the same `role`.
    494         # `bindings` with no members will result in an error.
    495       { # Associates `members` with a `role`.
    496         "role": "A String", # Role that is assigned to `members`.
    497             # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
    498             # Required
    499         "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
    500             # `members` can have the following values:
    501             #
    502             # * `allUsers`: A special identifier that represents anyone who is
    503             #    on the internet; with or without a Google account.
    504             #
    505             # * `allAuthenticatedUsers`: A special identifier that represents anyone
    506             #    who is authenticated with a Google account or a service account.
    507             #
    508             # * `user:{emailid}`: An email address that represents a specific Google
    509             #    account. For example, `alice (a] gmail.com` or `joe (a] example.com`.
    510             #
    511             #
    512             # * `serviceAccount:{emailid}`: An email address that represents a service
    513             #    account. For example, `my-other-app (a] appspot.gserviceaccount.com`.
    514             #
    515             # * `group:{emailid}`: An email address that represents a Google group.
    516             #    For example, `admins (a] example.com`.
    517             #
    518             #
    519             # * `domain:{domain}`: A Google Apps domain name that represents all the
    520             #    users of that domain. For example, `google.com` or `example.com`.
    521             #
    522           "A String",
    523         ],
    524       },
    525     ],
    526     "auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
    527       { # Specifies the audit configuration for a service.
    528           # The configuration determines which permission types are logged, and what
    529           # identities, if any, are exempted from logging.
    530           # An AuditConfig must have one or more AuditLogConfigs.
    531           #
    532           # If there are AuditConfigs for both `allServices` and a specific service,
    533           # the union of the two AuditConfigs is used for that service: the log_types
    534           # specified in each AuditConfig are enabled, and the exempted_members in each
    535           # AuditConfig are exempted.
    536           #
    537           # Example Policy with multiple AuditConfigs:
    538           #
    539           #     {
    540           #       "audit_configs": [
    541           #         {
    542           #           "service": "allServices"
    543           #           "audit_log_configs": [
    544           #             {
    545           #               "log_type": "DATA_READ",
    546           #               "exempted_members": [
    547           #                 "user:foo (a] gmail.com"
    548           #               ]
    549           #             },
    550           #             {
    551           #               "log_type": "DATA_WRITE",
    552           #             },
    553           #             {
    554           #               "log_type": "ADMIN_READ",
    555           #             }
    556           #           ]
    557           #         },
    558           #         {
    559           #           "service": "fooservice.googleapis.com"
    560           #           "audit_log_configs": [
    561           #             {
    562           #               "log_type": "DATA_READ",
    563           #             },
    564           #             {
    565           #               "log_type": "DATA_WRITE",
    566           #               "exempted_members": [
    567           #                 "user:bar (a] gmail.com"
    568           #               ]
    569           #             }
    570           #           ]
    571           #         }
    572           #       ]
    573           #     }
    574           #
    575           # For fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
    576           # logging. It also exempts foo (a] gmail.com from DATA_READ logging, and
    577           # bar (a] gmail.com from DATA_WRITE logging.
    578         "auditLogConfigs": [ # The configuration for logging of each type of permission.
    579             # Next ID: 4
    580           { # Provides the configuration for logging a type of permissions.
    581               # Example:
    582               #
    583               #     {
    584               #       "audit_log_configs": [
    585               #         {
    586               #           "log_type": "DATA_READ",
    587               #           "exempted_members": [
    588               #             "user:foo (a] gmail.com"
    589               #           ]
    590               #         },
    591               #         {
    592               #           "log_type": "DATA_WRITE",
    593               #         }
    594               #       ]
    595               #     }
    596               #
    597               # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting
    598               # foo (a] gmail.com from DATA_READ logging.
    599             "exemptedMembers": [ # Specifies the identities that do not cause logging for this type of
    600                 # permission.
    601                 # Follows the same format of Binding.members.
    602               "A String",
    603             ],
    604             "logType": "A String", # The log type that this config enables.
    605           },
    606         ],
    607         "service": "A String", # Specifies a service that will be enabled for audit logging.
    608             # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
    609             # `allServices` is a special value that covers all services.
    610       },
    611     ],
    612     "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
    613         # prevent simultaneous updates of a policy from overwriting each other.
    614         # It is strongly suggested that systems make use of the `etag` in the
    615         # read-modify-write cycle to perform policy updates in order to avoid race
    616         # conditions: An `etag` is returned in the response to `getIamPolicy`, and
    617         # systems are expected to put that etag in the request to `setIamPolicy` to
    618         # ensure that their change will be applied to the same version of the policy.
    619         #
    620         # If no `etag` is provided in the call to `setIamPolicy`, then the existing
    621         # policy is overwritten blindly.
    622     "version": 42, # Version of the `Policy`. The default version is 0.
    623   }</pre>
    624 </div>
    625 
    626 <div class="method">
    627     <code class="details" id="list">list(pageSize=None, filter=None, pageToken=None, x__xgafv=None)</code>
    628   <pre>Lists Projects that are visible to the user and satisfy the
    629 specified filter. This method returns Projects in an unspecified order.
    630 New Projects do not necessarily appear at the end of the list.
    631 
    632 Args:
    633   pageSize: integer, The maximum number of Projects to return in the response.
    634 The server can return fewer Projects than requested.
    635 If unspecified, server picks an appropriate default.
    636 
    637 Optional.
    638   filter: string, An expression for filtering the results of the request.  Filter rules are
    639 case insensitive. The fields eligible for filtering are:
    640 
    641 + `name`
    642 + `id`
    643 + <code>labels.<em>key</em></code> where *key* is the name of a label
    644 
    645 Some examples of using labels as filters:
    646 
    647 |Filter|Description|
    648 |------|-----------|
    649 |name:how*|The project's name starts with "how".|
    650 |name:Howl|The project's name is `Howl` or `howl`.|
    651 |name:HOWL|Equivalent to above.|
    652 |NAME:howl|Equivalent to above.|
    653 |labels.color:*|The project has the label `color`.|
    654 |labels.color:red|The project's label `color` has the value `red`.|
    655 |labels.color:red&nbsp;labels.size:big|The project's label `color` has the
    656 value `red` and its label `size` has the value `big`.
    657 
    658 Optional.
    659   pageToken: string, A pagination token returned from a previous call to ListProjects
    660 that indicates from where listing should continue.
    661 
    662 Optional.
    663   x__xgafv: string, V1 error format.
    664     Allowed values
    665       1 - v1 error format
    666       2 - v2 error format
    667 
    668 Returns:
    669   An object of the form:
    670 
    671     { # A page of the response received from the
    672       # ListProjects
    673       # method.
    674       #
    675       # A paginated response where more pages are available has
    676       # `next_page_token` set. This token can be used in a subsequent request to
    677       # retrieve the next request page.
    678     "nextPageToken": "A String", # Pagination token.
    679         #
    680         # If the result set is too large to fit in a single response, this token
    681         # is returned. It encodes the position of the current result cursor.
    682         # Feeding this value into a new list request with the `page_token` parameter
    683         # gives the next page of the results.
    684         #
    685         # When `next_page_token` is not filled in, there is no next page and
    686         # the list returned is the last page in the result set.
    687         #
    688         # Pagination tokens have a limited lifetime.
    689     "projects": [ # The list of Projects that matched the list filter. This list can
    690         # be paginated.
    691       { # A Project is a high-level Google Cloud Platform entity.  It is a
    692           # container for ACLs, APIs, App Engine Apps, VMs, and other
    693           # Google Cloud Platform resources.
    694         "name": "A String", # The user-assigned display name of the Project.
    695             # It must be 4 to 30 characters.
    696             # Allowed characters are: lowercase and uppercase letters, numbers,
    697             # hyphen, single-quote, double-quote, space, and exclamation point.
    698             #
    699             # Example: <code>My Project</code>
    700             # Read-write.
    701         "parent": { # A container to reference an id for any resource type. A `resource` in Google # An optional reference to a parent Resource.
    702             #
    703             # The only supported parent type is "organization". Once set, the parent
    704             # cannot be modified. The `parent` can be set on creation or using the
    705             # `UpdateProject` method; the end user must have the
    706             # `resourcemanager.projects.create` permission on the parent.
    707             #
    708             # Read-write.
    709             # Cloud Platform is a generic term for something you (a developer) may want to
    710             # interact with through one of our API's. Some examples are an App Engine app,
    711             # a Compute Engine instance, a Cloud SQL database, and so on.
    712           "type": "A String", # Required field representing the resource type this id is for.
    713               # At present, the valid types are "project" and "organization".
    714           "id": "A String", # Required field for the type-specific id. This should correspond to the id
    715               # used in the type-specific API's.
    716         },
    717         "projectId": "A String", # The unique, user-assigned ID of the Project.
    718             # It must be 6 to 30 lowercase letters, digits, or hyphens.
    719             # It must start with a letter.
    720             # Trailing hyphens are prohibited.
    721             #
    722             # Example: <code>tokyo-rain-123</code>
    723             # Read-only after creation.
    724         "labels": { # The labels associated with this Project.
    725             #
    726             # Label keys must be between 1 and 63 characters long and must conform
    727             # to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?.
    728             #
    729             # Label values must be between 0 and 63 characters long and must conform
    730             # to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
    731             #
    732             # No more than 256 labels can be associated with a given resource.
    733             #
    734             # Clients should store labels in a representation such as JSON that does not
    735             # depend on specific characters being disallowed.
    736             #
    737             # Example: <code>"environment" : "dev"</code>
    738             # Read-write.
    739           "a_key": "A String",
    740         },
    741         "projectNumber": "A String", # The number uniquely identifying the project.
    742             #
    743             # Example: <code>415104041262</code>
    744             # Read-only.
    745         "lifecycleState": "A String", # The Project lifecycle state.
    746             #
    747             # Read-only.
    748         "createTime": "A String", # Creation time.
    749             #
    750             # Read-only.
    751       },
    752     ],
    753   }</pre>
    754 </div>
    755 
    756 <div class="method">
    757     <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
    758   <pre>Retrieves the next page of results.
    759 
    760 Args:
    761   previous_request: The request for the previous page. (required)
    762   previous_response: The response from the request for the previous page. (required)
    763 
    764 Returns:
    765   A request object that you can call 'execute()' on to request the next
    766   page. Returns None if there are no more items in the collection.
    767     </pre>
    768 </div>
    769 
    770 <div class="method">
    771     <code class="details" id="setIamPolicy">setIamPolicy(resource, body, x__xgafv=None)</code>
    772   <pre>Sets the IAM access control policy for the specified Project. Replaces
    773 any existing policy.
    774 
    775 The following constraints apply when using `setIamPolicy()`:
    776 
    777 + Project does not support `allUsers` and `allAuthenticatedUsers` as
    778 `members` in a `Binding` of a `Policy`.
    779 
    780 + The owner role can be granted only to `user` and `serviceAccount`.
    781 
    782 + Service accounts can be made owners of a project directly
    783 without any restrictions. However, to be added as an owner, a user must be
    784 invited via Cloud Platform console and must accept the invitation.
    785 
    786 + A user cannot be granted the owner role using `setIamPolicy()`. The user
    787 must be granted the owner role using the Cloud Platform Console and must
    788 explicitly accept the invitation.
    789 
    790 + Invitations to grant the owner role cannot be sent using
    791 `setIamPolicy()`; they must be sent only using the Cloud Platform Console.
    792 
    793 + Membership changes that leave the project without any owners that have
    794 accepted the Terms of Service (ToS) will be rejected.
    795 
    796 + There must be at least one owner who has accepted the Terms of
    797 Service (ToS) agreement in the policy. Calling `setIamPolicy()` to
    798 remove the last ToS-accepted owner from the policy will fail. This
    799 restriction also applies to legacy projects that no longer have owners
    800 who have accepted the ToS. Edits to IAM policies will be rejected until
    801 the lack of a ToS-accepting owner is rectified.
    802 
    803 + Calling this method requires enabling the App Engine Admin API.
    804 
    805 Note: Removing service accounts from policies or changing their roles
    806 can render services completely inoperable. It is important to understand
    807 how the service account is being used before removing or updating its
    808 roles.
    809 
    810 Args:
    811   resource: string, REQUIRED: The resource for which the policy is being specified.
    812 See the operation documentation for the appropriate value for this field. (required)
    813   body: object, The request body. (required)
    814     The object takes the form of:
    815 
    816 { # Request message for `SetIamPolicy` method.
    817     "policy": { # Defines an Identity and Access Management (IAM) policy. It is used to # REQUIRED: The complete policy to be applied to the `resource`. The size of
    818         # the policy is limited to a few 10s of KB. An empty policy is a
    819         # valid policy but certain Cloud Platform services (such as Projects)
    820         # might reject them.
    821         # specify access control policies for Cloud Platform resources.
    822         #
    823         #
    824         # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
    825         # `members` to a `role`, where the members can be user accounts, Google groups,
    826         # Google domains, and service accounts. A `role` is a named list of permissions
    827         # defined by IAM.
    828         #
    829         # **Example**
    830         #
    831         #     {
    832         #       "bindings": [
    833         #         {
    834         #           "role": "roles/owner",
    835         #           "members": [
    836         #             "user:mike (a] example.com",
    837         #             "group:admins (a] example.com",
    838         #             "domain:google.com",
    839         #             "serviceAccount:my-other-app (a] appspot.gserviceaccount.com",
    840         #           ]
    841         #         },
    842         #         {
    843         #           "role": "roles/viewer",
    844         #           "members": ["user:sean (a] example.com"]
    845         #         }
    846         #       ]
    847         #     }
    848         #
    849         # For a description of IAM and its features, see the
    850         # [IAM developer's guide](https://cloud.google.com/iam).
    851       "bindings": [ # Associates a list of `members` to a `role`.
    852           # Multiple `bindings` must not be specified for the same `role`.
    853           # `bindings` with no members will result in an error.
    854         { # Associates `members` with a `role`.
    855           "role": "A String", # Role that is assigned to `members`.
    856               # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
    857               # Required
    858           "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
    859               # `members` can have the following values:
    860               #
    861               # * `allUsers`: A special identifier that represents anyone who is
    862               #    on the internet; with or without a Google account.
    863               #
    864               # * `allAuthenticatedUsers`: A special identifier that represents anyone
    865               #    who is authenticated with a Google account or a service account.
    866               #
    867               # * `user:{emailid}`: An email address that represents a specific Google
    868               #    account. For example, `alice (a] gmail.com` or `joe (a] example.com`.
    869               #
    870               #
    871               # * `serviceAccount:{emailid}`: An email address that represents a service
    872               #    account. For example, `my-other-app (a] appspot.gserviceaccount.com`.
    873               #
    874               # * `group:{emailid}`: An email address that represents a Google group.
    875               #    For example, `admins (a] example.com`.
    876               #
    877               #
    878               # * `domain:{domain}`: A Google Apps domain name that represents all the
    879               #    users of that domain. For example, `google.com` or `example.com`.
    880               #
    881             "A String",
    882           ],
    883         },
    884       ],
    885       "auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
    886         { # Specifies the audit configuration for a service.
    887             # The configuration determines which permission types are logged, and what
    888             # identities, if any, are exempted from logging.
    889             # An AuditConfig must have one or more AuditLogConfigs.
    890             #
    891             # If there are AuditConfigs for both `allServices` and a specific service,
    892             # the union of the two AuditConfigs is used for that service: the log_types
    893             # specified in each AuditConfig are enabled, and the exempted_members in each
    894             # AuditConfig are exempted.
    895             #
    896             # Example Policy with multiple AuditConfigs:
    897             #
    898             #     {
    899             #       "audit_configs": [
    900             #         {
    901             #           "service": "allServices"
    902             #           "audit_log_configs": [
    903             #             {
    904             #               "log_type": "DATA_READ",
    905             #               "exempted_members": [
    906             #                 "user:foo (a] gmail.com"
    907             #               ]
    908             #             },
    909             #             {
    910             #               "log_type": "DATA_WRITE",
    911             #             },
    912             #             {
    913             #               "log_type": "ADMIN_READ",
    914             #             }
    915             #           ]
    916             #         },
    917             #         {
    918             #           "service": "fooservice.googleapis.com"
    919             #           "audit_log_configs": [
    920             #             {
    921             #               "log_type": "DATA_READ",
    922             #             },
    923             #             {
    924             #               "log_type": "DATA_WRITE",
    925             #               "exempted_members": [
    926             #                 "user:bar (a] gmail.com"
    927             #               ]
    928             #             }
    929             #           ]
    930             #         }
    931             #       ]
    932             #     }
    933             #
    934             # For fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
    935             # logging. It also exempts foo (a] gmail.com from DATA_READ logging, and
    936             # bar (a] gmail.com from DATA_WRITE logging.
    937           "auditLogConfigs": [ # The configuration for logging of each type of permission.
    938               # Next ID: 4
    939             { # Provides the configuration for logging a type of permissions.
    940                 # Example:
    941                 #
    942                 #     {
    943                 #       "audit_log_configs": [
    944                 #         {
    945                 #           "log_type": "DATA_READ",
    946                 #           "exempted_members": [
    947                 #             "user:foo (a] gmail.com"
    948                 #           ]
    949                 #         },
    950                 #         {
    951                 #           "log_type": "DATA_WRITE",
    952                 #         }
    953                 #       ]
    954                 #     }
    955                 #
    956                 # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting
    957                 # foo (a] gmail.com from DATA_READ logging.
    958               "exemptedMembers": [ # Specifies the identities that do not cause logging for this type of
    959                   # permission.
    960                   # Follows the same format of Binding.members.
    961                 "A String",
    962               ],
    963               "logType": "A String", # The log type that this config enables.
    964             },
    965           ],
    966           "service": "A String", # Specifies a service that will be enabled for audit logging.
    967               # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
    968               # `allServices` is a special value that covers all services.
    969         },
    970       ],
    971       "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
    972           # prevent simultaneous updates of a policy from overwriting each other.
    973           # It is strongly suggested that systems make use of the `etag` in the
    974           # read-modify-write cycle to perform policy updates in order to avoid race
    975           # conditions: An `etag` is returned in the response to `getIamPolicy`, and
    976           # systems are expected to put that etag in the request to `setIamPolicy` to
    977           # ensure that their change will be applied to the same version of the policy.
    978           #
    979           # If no `etag` is provided in the call to `setIamPolicy`, then the existing
    980           # policy is overwritten blindly.
    981       "version": 42, # Version of the `Policy`. The default version is 0.
    982     },
    983     "updateMask": "A String", # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only
    984         # the fields in the mask will be modified. If no mask is provided, the
    985         # following default mask is used:
    986         # paths: "bindings, etag"
    987         # This field is only used by Cloud IAM.
    988   }
    989 
    990   x__xgafv: string, V1 error format.
    991     Allowed values
    992       1 - v1 error format
    993       2 - v2 error format
    994 
    995 Returns:
    996   An object of the form:
    997 
    998     { # Defines an Identity and Access Management (IAM) policy. It is used to
    999       # specify access control policies for Cloud Platform resources.
   1000       #
   1001       #
   1002       # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
   1003       # `members` to a `role`, where the members can be user accounts, Google groups,
   1004       # Google domains, and service accounts. A `role` is a named list of permissions
   1005       # defined by IAM.
   1006       #
   1007       # **Example**
   1008       #
   1009       #     {
   1010       #       "bindings": [
   1011       #         {
   1012       #           "role": "roles/owner",
   1013       #           "members": [
   1014       #             "user:mike (a] example.com",
   1015       #             "group:admins (a] example.com",
   1016       #             "domain:google.com",
   1017       #             "serviceAccount:my-other-app (a] appspot.gserviceaccount.com",
   1018       #           ]
   1019       #         },
   1020       #         {
   1021       #           "role": "roles/viewer",
   1022       #           "members": ["user:sean (a] example.com"]
   1023       #         }
   1024       #       ]
   1025       #     }
   1026       #
   1027       # For a description of IAM and its features, see the
   1028       # [IAM developer's guide](https://cloud.google.com/iam).
   1029     "bindings": [ # Associates a list of `members` to a `role`.
   1030         # Multiple `bindings` must not be specified for the same `role`.
   1031         # `bindings` with no members will result in an error.
   1032       { # Associates `members` with a `role`.
   1033         "role": "A String", # Role that is assigned to `members`.
   1034             # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
   1035             # Required
   1036         "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
   1037             # `members` can have the following values:
   1038             #
   1039             # * `allUsers`: A special identifier that represents anyone who is
   1040             #    on the internet; with or without a Google account.
   1041             #
   1042             # * `allAuthenticatedUsers`: A special identifier that represents anyone
   1043             #    who is authenticated with a Google account or a service account.
   1044             #
   1045             # * `user:{emailid}`: An email address that represents a specific Google
   1046             #    account. For example, `alice (a] gmail.com` or `joe (a] example.com`.
   1047             #
   1048             #
   1049             # * `serviceAccount:{emailid}`: An email address that represents a service
   1050             #    account. For example, `my-other-app (a] appspot.gserviceaccount.com`.
   1051             #
   1052             # * `group:{emailid}`: An email address that represents a Google group.
   1053             #    For example, `admins (a] example.com`.
   1054             #
   1055             #
   1056             # * `domain:{domain}`: A Google Apps domain name that represents all the
   1057             #    users of that domain. For example, `google.com` or `example.com`.
   1058             #
   1059           "A String",
   1060         ],
   1061       },
   1062     ],
   1063     "auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
   1064       { # Specifies the audit configuration for a service.
   1065           # The configuration determines which permission types are logged, and what
   1066           # identities, if any, are exempted from logging.
   1067           # An AuditConfig must have one or more AuditLogConfigs.
   1068           #
   1069           # If there are AuditConfigs for both `allServices` and a specific service,
   1070           # the union of the two AuditConfigs is used for that service: the log_types
   1071           # specified in each AuditConfig are enabled, and the exempted_members in each
   1072           # AuditConfig are exempted.
   1073           #
   1074           # Example Policy with multiple AuditConfigs:
   1075           #
   1076           #     {
   1077           #       "audit_configs": [
   1078           #         {
   1079           #           "service": "allServices"
   1080           #           "audit_log_configs": [
   1081           #             {
   1082           #               "log_type": "DATA_READ",
   1083           #               "exempted_members": [
   1084           #                 "user:foo (a] gmail.com"
   1085           #               ]
   1086           #             },
   1087           #             {
   1088           #               "log_type": "DATA_WRITE",
   1089           #             },
   1090           #             {
   1091           #               "log_type": "ADMIN_READ",
   1092           #             }
   1093           #           ]
   1094           #         },
   1095           #         {
   1096           #           "service": "fooservice.googleapis.com"
   1097           #           "audit_log_configs": [
   1098           #             {
   1099           #               "log_type": "DATA_READ",
   1100           #             },
   1101           #             {
   1102           #               "log_type": "DATA_WRITE",
   1103           #               "exempted_members": [
   1104           #                 "user:bar (a] gmail.com"
   1105           #               ]
   1106           #             }
   1107           #           ]
   1108           #         }
   1109           #       ]
   1110           #     }
   1111           #
   1112           # For fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
   1113           # logging. It also exempts foo (a] gmail.com from DATA_READ logging, and
   1114           # bar (a] gmail.com from DATA_WRITE logging.
   1115         "auditLogConfigs": [ # The configuration for logging of each type of permission.
   1116             # Next ID: 4
   1117           { # Provides the configuration for logging a type of permissions.
   1118               # Example:
   1119               #
   1120               #     {
   1121               #       "audit_log_configs": [
   1122               #         {
   1123               #           "log_type": "DATA_READ",
   1124               #           "exempted_members": [
   1125               #             "user:foo (a] gmail.com"
   1126               #           ]
   1127               #         },
   1128               #         {
   1129               #           "log_type": "DATA_WRITE",
   1130               #         }
   1131               #       ]
   1132               #     }
   1133               #
   1134               # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting
   1135               # foo (a] gmail.com from DATA_READ logging.
   1136             "exemptedMembers": [ # Specifies the identities that do not cause logging for this type of
   1137                 # permission.
   1138                 # Follows the same format of Binding.members.
   1139               "A String",
   1140             ],
   1141             "logType": "A String", # The log type that this config enables.
   1142           },
   1143         ],
   1144         "service": "A String", # Specifies a service that will be enabled for audit logging.
   1145             # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
   1146             # `allServices` is a special value that covers all services.
   1147       },
   1148     ],
   1149     "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
   1150         # prevent simultaneous updates of a policy from overwriting each other.
   1151         # It is strongly suggested that systems make use of the `etag` in the
   1152         # read-modify-write cycle to perform policy updates in order to avoid race
   1153         # conditions: An `etag` is returned in the response to `getIamPolicy`, and
   1154         # systems are expected to put that etag in the request to `setIamPolicy` to
   1155         # ensure that their change will be applied to the same version of the policy.
   1156         #
   1157         # If no `etag` is provided in the call to `setIamPolicy`, then the existing
   1158         # policy is overwritten blindly.
   1159     "version": 42, # Version of the `Policy`. The default version is 0.
   1160   }</pre>
   1161 </div>
   1162 
   1163 <div class="method">
   1164     <code class="details" id="testIamPermissions">testIamPermissions(resource, body, x__xgafv=None)</code>
   1165   <pre>Returns permissions that a caller has on the specified Project.
   1166 
   1167 Args:
   1168   resource: string, REQUIRED: The resource for which the policy detail is being requested.
   1169 See the operation documentation for the appropriate value for this field. (required)
   1170   body: object, The request body. (required)
   1171     The object takes the form of:
   1172 
   1173 { # Request message for `TestIamPermissions` method.
   1174     "permissions": [ # The set of permissions to check for the `resource`. Permissions with
   1175         # wildcards (such as '*' or 'storage.*') are not allowed. For more
   1176         # information see
   1177         # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
   1178       "A String",
   1179     ],
   1180   }
   1181 
   1182   x__xgafv: string, V1 error format.
   1183     Allowed values
   1184       1 - v1 error format
   1185       2 - v2 error format
   1186 
   1187 Returns:
   1188   An object of the form:
   1189 
   1190     { # Response message for `TestIamPermissions` method.
   1191     "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is
   1192         # allowed.
   1193       "A String",
   1194     ],
   1195   }</pre>
   1196 </div>
   1197 
   1198 <div class="method">
   1199     <code class="details" id="undelete">undelete(projectId, body, x__xgafv=None)</code>
   1200   <pre>Restores the Project identified by the specified
   1201 `project_id` (for example, `my-project-123`).
   1202 You can only use this method for a Project that has a lifecycle state of
   1203 DELETE_REQUESTED.
   1204 After deletion starts, the Project cannot be restored.
   1205 
   1206 The caller must have modify permissions for this Project.
   1207 
   1208 Args:
   1209   projectId: string, The project ID (for example, `foo-bar-123`).
   1210 
   1211 Required. (required)
   1212   body: object, The request body. (required)
   1213     The object takes the form of:
   1214 
   1215 { # The request sent to the UndeleteProject
   1216       # method.
   1217   }
   1218 
   1219   x__xgafv: string, V1 error format.
   1220     Allowed values
   1221       1 - v1 error format
   1222       2 - v2 error format
   1223 
   1224 Returns:
   1225   An object of the form:
   1226 
   1227     { # A generic empty message that you can re-use to avoid defining duplicated
   1228       # empty messages in your APIs. A typical example is to use it as the request
   1229       # or the response type of an API method. For instance:
   1230       #
   1231       #     service Foo {
   1232       #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
   1233       #     }
   1234       #
   1235       # The JSON representation for `Empty` is empty JSON object `{}`.
   1236   }</pre>
   1237 </div>
   1238 
   1239 <div class="method">
   1240     <code class="details" id="update">update(projectId, body, x__xgafv=None)</code>
   1241   <pre>Updates the attributes of the Project identified by the specified
   1242 `project_id` (for example, `my-project-123`).
   1243 
   1244 The caller must have modify permissions for this Project.
   1245 
   1246 Args:
   1247   projectId: string, The project ID (for example, `my-project-123`).
   1248 
   1249 Required. (required)
   1250   body: object, The request body. (required)
   1251     The object takes the form of:
   1252 
   1253 { # A Project is a high-level Google Cloud Platform entity.  It is a
   1254     # container for ACLs, APIs, App Engine Apps, VMs, and other
   1255     # Google Cloud Platform resources.
   1256   "name": "A String", # The user-assigned display name of the Project.
   1257       # It must be 4 to 30 characters.
   1258       # Allowed characters are: lowercase and uppercase letters, numbers,
   1259       # hyphen, single-quote, double-quote, space, and exclamation point.
   1260       # 
   1261       # Example: <code>My Project</code>
   1262       # Read-write.
   1263   "parent": { # A container to reference an id for any resource type. A `resource` in Google # An optional reference to a parent Resource.
   1264       # 
   1265       # The only supported parent type is "organization". Once set, the parent
   1266       # cannot be modified. The `parent` can be set on creation or using the
   1267       # `UpdateProject` method; the end user must have the
   1268       # `resourcemanager.projects.create` permission on the parent.
   1269       # 
   1270       # Read-write.
   1271       # Cloud Platform is a generic term for something you (a developer) may want to
   1272       # interact with through one of our API's. Some examples are an App Engine app,
   1273       # a Compute Engine instance, a Cloud SQL database, and so on.
   1274     "type": "A String", # Required field representing the resource type this id is for.
   1275         # At present, the valid types are "project" and "organization".
   1276     "id": "A String", # Required field for the type-specific id. This should correspond to the id
   1277         # used in the type-specific API's.
   1278   },
   1279   "projectId": "A String", # The unique, user-assigned ID of the Project.
   1280       # It must be 6 to 30 lowercase letters, digits, or hyphens.
   1281       # It must start with a letter.
   1282       # Trailing hyphens are prohibited.
   1283       # 
   1284       # Example: <code>tokyo-rain-123</code>
   1285       # Read-only after creation.
   1286   "labels": { # The labels associated with this Project.
   1287       # 
   1288       # Label keys must be between 1 and 63 characters long and must conform
   1289       # to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?.
   1290       # 
   1291       # Label values must be between 0 and 63 characters long and must conform
   1292       # to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
   1293       # 
   1294       # No more than 256 labels can be associated with a given resource.
   1295       # 
   1296       # Clients should store labels in a representation such as JSON that does not
   1297       # depend on specific characters being disallowed.
   1298       # 
   1299       # Example: <code>"environment" : "dev"</code>
   1300       # Read-write.
   1301     "a_key": "A String",
   1302   },
   1303   "projectNumber": "A String", # The number uniquely identifying the project.
   1304       # 
   1305       # Example: <code>415104041262</code>
   1306       # Read-only.
   1307   "lifecycleState": "A String", # The Project lifecycle state.
   1308       # 
   1309       # Read-only.
   1310   "createTime": "A String", # Creation time.
   1311       # 
   1312       # Read-only.
   1313 }
   1314 
   1315   x__xgafv: string, V1 error format.
   1316     Allowed values
   1317       1 - v1 error format
   1318       2 - v2 error format
   1319 
   1320 Returns:
   1321   An object of the form:
   1322 
   1323     { # A Project is a high-level Google Cloud Platform entity.  It is a
   1324       # container for ACLs, APIs, App Engine Apps, VMs, and other
   1325       # Google Cloud Platform resources.
   1326     "name": "A String", # The user-assigned display name of the Project.
   1327         # It must be 4 to 30 characters.
   1328         # Allowed characters are: lowercase and uppercase letters, numbers,
   1329         # hyphen, single-quote, double-quote, space, and exclamation point.
   1330         #
   1331         # Example: <code>My Project</code>
   1332         # Read-write.
   1333     "parent": { # A container to reference an id for any resource type. A `resource` in Google # An optional reference to a parent Resource.
   1334         #
   1335         # The only supported parent type is "organization". Once set, the parent
   1336         # cannot be modified. The `parent` can be set on creation or using the
   1337         # `UpdateProject` method; the end user must have the
   1338         # `resourcemanager.projects.create` permission on the parent.
   1339         #
   1340         # Read-write.
   1341         # Cloud Platform is a generic term for something you (a developer) may want to
   1342         # interact with through one of our API's. Some examples are an App Engine app,
   1343         # a Compute Engine instance, a Cloud SQL database, and so on.
   1344       "type": "A String", # Required field representing the resource type this id is for.
   1345           # At present, the valid types are "project" and "organization".
   1346       "id": "A String", # Required field for the type-specific id. This should correspond to the id
   1347           # used in the type-specific API's.
   1348     },
   1349     "projectId": "A String", # The unique, user-assigned ID of the Project.
   1350         # It must be 6 to 30 lowercase letters, digits, or hyphens.
   1351         # It must start with a letter.
   1352         # Trailing hyphens are prohibited.
   1353         #
   1354         # Example: <code>tokyo-rain-123</code>
   1355         # Read-only after creation.
   1356     "labels": { # The labels associated with this Project.
   1357         #
   1358         # Label keys must be between 1 and 63 characters long and must conform
   1359         # to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?.
   1360         #
   1361         # Label values must be between 0 and 63 characters long and must conform
   1362         # to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
   1363         #
   1364         # No more than 256 labels can be associated with a given resource.
   1365         #
   1366         # Clients should store labels in a representation such as JSON that does not
   1367         # depend on specific characters being disallowed.
   1368         #
   1369         # Example: <code>"environment" : "dev"</code>
   1370         # Read-write.
   1371       "a_key": "A String",
   1372     },
   1373     "projectNumber": "A String", # The number uniquely identifying the project.
   1374         #
   1375         # Example: <code>415104041262</code>
   1376         # Read-only.
   1377     "lifecycleState": "A String", # The Project lifecycle state.
   1378         #
   1379         # Read-only.
   1380     "createTime": "A String", # Creation time.
   1381         #
   1382         # Read-only.
   1383   }</pre>
   1384 </div>
   1385 
   1386 </body></html>