blob: b71df1db14882b3bbce1ef06f5ae415a123a2d76 [file] [log] [blame]
Bu Sun Kim65020912020-05-20 12:08:20 -07001<html><body>
2<style>
3
4body, 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
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, 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="firebase_v1beta1.html">Firebase Management API</a> . <a href="firebase_v1beta1.projects.html">projects</a> . <a href="firebase_v1beta1.projects.defaultLocation.html">defaultLocation</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="#finalize">finalize(parent, body=None, x__xgafv=None)</a></code></p>
79<p class="firstline">Sets the default Google Cloud Platform (GCP) resource location for the</p>
80<h3>Method Details</h3>
81<div class="method">
82 <code class="details" id="finalize">finalize(parent, body=None, x__xgafv=None)</code>
83 <pre>Sets the default Google Cloud Platform (GCP) resource location for the
84specified FirebaseProject.
85&lt;br&gt;
86&lt;br&gt;This method creates an App Engine application with a
87[default Cloud Storage
88bucket](https://cloud.google.com/appengine/docs/standard/python/googlecloudstorageclient/setting-up-cloud-storage#activating_a_cloud_storage_bucket),
89located in the specified
90[`location_id`](#body.request_body.FIELDS.location_id).
91This location must be one of the available
92[GCP resource
93locations](https://firebase.google.com/docs/projects/locations). &lt;br&gt;
94&lt;br&gt;After the default GCP resource location is finalized, or if it was
95already set, it cannot be changed. The default GCP resource location for
96the specified FirebaseProject might already be set because either the
97GCP `Project` already has an App Engine application or
98`FinalizeDefaultLocation` was previously called with a specified
99`location_id`. Any new calls to `FinalizeDefaultLocation` with a
100&lt;em&gt;different&lt;/em&gt; specified `location_id` will return a 409 error.
101&lt;br&gt;
102&lt;br&gt;The result of this call is an [`Operation`](../../v1beta1/operations),
103which can be used to track the provisioning process. The
104[`response`](../../v1beta1/operations#Operation.FIELDS.response) type of
105the `Operation` is google.protobuf.Empty.
106&lt;br&gt;
107&lt;br&gt;The `Operation` can be polled by its `name` using
108GetOperation until `done` is
109true. When `done` is true, the `Operation` has either succeeded or failed.
110If the `Operation` has succeeded, its
111[`response`](../../v1beta1/operations#Operation.FIELDS.response) will be
112set to a google.protobuf.Empty; if the `Operation` has failed, its
113`error` will be set to a google.rpc.Status. The `Operation` is
114automatically deleted after completion, so there is no need to call
115DeleteOperation.
116&lt;br&gt;
117&lt;br&gt;All fields listed in the [request body](#request-body) are required.
118&lt;br&gt;
119&lt;br&gt;To call `FinalizeDefaultLocation`, a member must be an Owner
120of the project.
121
122Args:
123 parent: string, The resource name of the Project for which the default GCP resource
124location will be set, in the format:
125&lt;br&gt;&lt;code&gt;projects/&lt;var&gt;projectId&lt;/var&gt;&lt;/code&gt; (required)
126 body: object, The request body.
127 The object takes the form of:
128
129{
130 &quot;locationId&quot;: &quot;A String&quot;, # The ID of the default GCP resource location for the Project. The location
131 # must be one of the available
132 # [GCP resource
133 # locations](https://firebase.google.com/docs/projects/locations).
134 }
135
136 x__xgafv: string, V1 error format.
137 Allowed values
138 1 - v1 error format
139 2 - v2 error format
140
141Returns:
142 An object of the form:
143
144 { # This resource represents a long-running operation that is the result of a
145 # network API call.
146 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress.
147 # If `true`, the operation is completed, and either `error` or `response` is
148 # available.
149 &quot;response&quot;: { # The normal response of the operation in case of success. If the original
150 # method returns no data on success, such as `Delete`, the response is
151 # `google.protobuf.Empty`. If the original method is standard
152 # `Get`/`Create`/`Update`, the response should be the resource. For other
153 # methods, the response should have the type `XxxResponse`, where `Xxx`
154 # is the original method name. For example, if the original method name
155 # is `TakeSnapshot()`, the inferred response type is
156 # `TakeSnapshotResponse`.
157 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
158 },
159 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that
160 # originally returns it. If you use the default HTTP mapping, the
161 # `name` should be a resource name ending with `operations/{unique_id}`.
162 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
163 # different programming environments, including REST APIs and RPC APIs. It is
164 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
165 # three pieces of data: error code, error message, and error details.
166 #
167 # You can find out more about this error model and how to work with it in the
168 # [API Design Guide](https://cloud.google.com/apis/design/errors).
169 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
170 # user-facing error message should be localized and sent in the
171 # google.rpc.Status.details field, or localized by the client.
172 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
173 # message types for APIs to use.
174 {
175 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
176 },
177 ],
178 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
179 },
180 &quot;metadata&quot;: { # Service-specific metadata associated with the operation. It typically
181 # contains progress information and common metadata such as create time.
182 # Some services might not provide such metadata. Any method that returns a
183 # long-running operation should document the metadata type, if any.
184 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
185 },
186 }</pre>
187</div>
188
189</body></html>