Skip to content

Commit d536b31

Browse files
feat(cloudbilling): update the api
#### cloudbilling:v1 The following keys were added: - resources.billingAccounts.methods.create.parameters.parent (Total Keys: 2) - resources.billingAccounts.methods.list.parameters.parent (Total Keys: 2) - resources.billingAccounts.methods.move (Total Keys: 12) - resources.billingAccounts.resources.subAccounts.methods.create (Total Keys: 12) - resources.billingAccounts.resources.subAccounts.methods.list (Total Keys: 18) - resources.organizations.resources.billingAccounts.methods.create (Total Keys: 12) - resources.organizations.resources.billingAccounts.methods.list (Total Keys: 18) - resources.organizations.resources.billingAccounts.methods.move (Total Keys: 15) - schemas.MoveBillingAccountRequest (Total Keys: 3)
1 parent 38e594d commit d536b31

7 files changed

+751
-7
lines changed

docs/dyn/cloudbilling_v1.billingAccounts.html

Lines changed: 43 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -79,11 +79,16 @@ <h2>Instance Methods</h2>
7979
</p>
8080
<p class="firstline">Returns the projects Resource.</p>
8181

82+
<p class="toc_element">
83+
<code><a href="cloudbilling_v1.billingAccounts.subAccounts.html">subAccounts()</a></code>
84+
</p>
85+
<p class="firstline">Returns the subAccounts Resource.</p>
86+
8287
<p class="toc_element">
8388
<code><a href="#close">close()</a></code></p>
8489
<p class="firstline">Close httplib2 connections.</p>
8590
<p class="toc_element">
86-
<code><a href="#create">create(body=None, x__xgafv=None)</a></code></p>
91+
<code><a href="#create">create(body=None, parent=None, x__xgafv=None)</a></code></p>
8792
<p class="firstline">This method creates [billing subaccounts](https://cloud.google.com/billing/docs/concepts#subaccounts). Google Cloud resellers should use the Channel Services APIs, [accounts.customers.create](https://cloud.google.com/channel/docs/reference/rest/v1/accounts.customers/create) and [accounts.customers.entitlements.create](https://cloud.google.com/channel/docs/reference/rest/v1/accounts.customers.entitlements/create). When creating a subaccount, the current authenticated user must have the `billing.accounts.update` IAM permission on the parent account, which is typically given to billing account [administrators](https://cloud.google.com/billing/docs/how-to/billing-access). This method will return an error if the parent account has not been provisioned for subaccounts.</p>
8893
<p class="toc_element">
8994
<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
@@ -92,11 +97,14 @@ <h2>Instance Methods</h2>
9297
<code><a href="#getIamPolicy">getIamPolicy(resource, options_requestedPolicyVersion=None, x__xgafv=None)</a></code></p>
9398
<p class="firstline">Gets the access control policy for a billing account. The caller must have the `billing.accounts.getIamPolicy` permission on the account, which is often given to billing account [viewers](https://cloud.google.com/billing/docs/how-to/billing-access).</p>
9499
<p class="toc_element">
95-
<code><a href="#list">list(filter=None, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
100+
<code><a href="#list">list(filter=None, pageSize=None, pageToken=None, parent=None, x__xgafv=None)</a></code></p>
96101
<p class="firstline">Lists the billing accounts that the current authenticated user has permission to [view](https://cloud.google.com/billing/docs/how-to/billing-access).</p>
97102
<p class="toc_element">
98103
<code><a href="#list_next">list_next()</a></code></p>
99104
<p class="firstline">Retrieves the next page of results.</p>
105+
<p class="toc_element">
106+
<code><a href="#move">move(name, body=None, x__xgafv=None)</a></code></p>
107+
<p class="firstline">Changes which parent organization a billing account belongs to.</p>
100108
<p class="toc_element">
101109
<code><a href="#patch">patch(name, body=None, updateMask=None, x__xgafv=None)</a></code></p>
102110
<p class="firstline">Updates a billing account's fields. Currently the only field that can be edited is `display_name`. The current authenticated user must have the `billing.accounts.update` IAM permission, which is typically given to the [administrator](https://cloud.google.com/billing/docs/how-to/billing-access) of the billing account.</p>
@@ -113,7 +121,7 @@ <h3>Method Details</h3>
113121
</div>
114122

115123
<div class="method">
116-
<code class="details" id="create">create(body=None, x__xgafv=None)</code>
124+
<code class="details" id="create">create(body=None, parent=None, x__xgafv=None)</code>
117125
<pre>This method creates [billing subaccounts](https://cloud.google.com/billing/docs/concepts#subaccounts). Google Cloud resellers should use the Channel Services APIs, [accounts.customers.create](https://cloud.google.com/channel/docs/reference/rest/v1/accounts.customers/create) and [accounts.customers.entitlements.create](https://cloud.google.com/channel/docs/reference/rest/v1/accounts.customers.entitlements/create). When creating a subaccount, the current authenticated user must have the `billing.accounts.update` IAM permission on the parent account, which is typically given to billing account [administrators](https://cloud.google.com/billing/docs/how-to/billing-access). This method will return an error if the parent account has not been provisioned for subaccounts.
118126

119127
Args:
@@ -127,6 +135,7 @@ <h3>Method Details</h3>
127135
&quot;open&quot;: True or False, # Output only. True if the billing account is open, and will therefore be charged for any usage on associated projects. False if the billing account is closed, and therefore projects associated with it will be unable to use paid services.
128136
}
129137

138+
parent: string, Optional. The parent to create a billing account from. Format: - organizations/{organization_id} eg organizations/12345678 - billingAccounts/{billing_account_id} eg `billingAccounts/012345-567890-ABCDEF`
130139
x__xgafv: string, V1 error format.
131140
Allowed values
132141
1 - v1 error format
@@ -214,13 +223,14 @@ <h3>Method Details</h3>
214223
</div>
215224

216225
<div class="method">
217-
<code class="details" id="list">list(filter=None, pageSize=None, pageToken=None, x__xgafv=None)</code>
226+
<code class="details" id="list">list(filter=None, pageSize=None, pageToken=None, parent=None, x__xgafv=None)</code>
218227
<pre>Lists the billing accounts that the current authenticated user has permission to [view](https://cloud.google.com/billing/docs/how-to/billing-access).
219228

220229
Args:
221230
filter: string, Options for how to filter the returned billing accounts. This only supports filtering for [subaccounts](https://cloud.google.com/billing/docs/concepts) under a single provided parent billing account. (e.g. &quot;master_billing_account=billingAccounts/012345-678901-ABCDEF&quot;). Boolean algebra and other fields are not currently supported.
222231
pageSize: integer, Requested page size. The maximum page size is 100; this is also the default.
223232
pageToken: string, A token identifying a page of results to return. This should be a `next_page_token` value returned from a previous `ListBillingAccounts` call. If unspecified, the first page of results is returned.
233+
parent: string, Optional. The parent resource to list billing accounts from. Format: - organizations/{organization_id} eg organizations/12345678 - billingAccounts/{billing_account_id} eg `billingAccounts/012345-567890-ABCDEF`
224234
x__xgafv: string, V1 error format.
225235
Allowed values
226236
1 - v1 error format
@@ -256,6 +266,35 @@ <h3>Method Details</h3>
256266
</pre>
257267
</div>
258268

269+
<div class="method">
270+
<code class="details" id="move">move(name, body=None, x__xgafv=None)</code>
271+
<pre>Changes which parent organization a billing account belongs to.
272+
273+
Args:
274+
name: string, Required. The resource name of the billing account to move. Must be of the form `billingAccounts/{billing_account_id}`. The specified billing account cannot be a subaccount, since a subaccount always belongs to the same organization as its parent account. (required)
275+
body: object, The request body.
276+
The object takes the form of:
277+
278+
{ # Request message for `MoveBillingAccount` RPC.
279+
&quot;destinationParent&quot;: &quot;A String&quot;, # Required. The resource name of the Organization to reparent the billing account under. Must be of the form `organizations/{organization_id}`.
280+
}
281+
282+
x__xgafv: string, V1 error format.
283+
Allowed values
284+
1 - v1 error format
285+
2 - v2 error format
286+
287+
Returns:
288+
An object of the form:
289+
290+
{ # A billing account in the [Google Cloud Console](https://console.cloud.google.com/). You can assign a billing account to one or more projects.
291+
&quot;displayName&quot;: &quot;A String&quot;, # The display name given to the billing account, such as `My Billing Account`. This name is displayed in the Google Cloud Console.
292+
&quot;masterBillingAccount&quot;: &quot;A String&quot;, # If this account is a [subaccount](https://cloud.google.com/billing/docs/concepts), then this will be the resource name of the parent billing account that it is being resold through. Otherwise this will be empty.
293+
&quot;name&quot;: &quot;A String&quot;, # Output only. The resource name of the billing account. The resource name has the form `billingAccounts/{billing_account_id}`. For example, `billingAccounts/012345-567890-ABCDEF` would be the resource name for billing account `012345-567890-ABCDEF`.
294+
&quot;open&quot;: True or False, # Output only. True if the billing account is open, and will therefore be charged for any usage on associated projects. False if the billing account is closed, and therefore projects associated with it will be unable to use paid services.
295+
}</pre>
296+
</div>
297+
259298
<div class="method">
260299
<code class="details" id="patch">patch(name, body=None, updateMask=None, x__xgafv=None)</code>
261300
<pre>Updates a billing account&#x27;s fields. Currently the only field that can be edited is `display_name`. The current authenticated user must have the `billing.accounts.update` IAM permission, which is typically given to the [administrator](https://cloud.google.com/billing/docs/how-to/billing-access) of the billing account.
Lines changed: 171 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,171 @@
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="cloudbilling_v1.html">Cloud Billing API</a> . <a href="cloudbilling_v1.billingAccounts.html">billingAccounts</a> . <a href="cloudbilling_v1.billingAccounts.subAccounts.html">subAccounts</a></h1>
76+
<h2>Instance Methods</h2>
77+
<p class="toc_element">
78+
<code><a href="#close">close()</a></code></p>
79+
<p class="firstline">Close httplib2 connections.</p>
80+
<p class="toc_element">
81+
<code><a href="#create">create(parent, body=None, x__xgafv=None)</a></code></p>
82+
<p class="firstline">This method creates [billing subaccounts](https://cloud.google.com/billing/docs/concepts#subaccounts). Google Cloud resellers should use the Channel Services APIs, [accounts.customers.create](https://cloud.google.com/channel/docs/reference/rest/v1/accounts.customers/create) and [accounts.customers.entitlements.create](https://cloud.google.com/channel/docs/reference/rest/v1/accounts.customers.entitlements/create). When creating a subaccount, the current authenticated user must have the `billing.accounts.update` IAM permission on the parent account, which is typically given to billing account [administrators](https://cloud.google.com/billing/docs/how-to/billing-access). This method will return an error if the parent account has not been provisioned for subaccounts.</p>
83+
<p class="toc_element">
84+
<code><a href="#list">list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
85+
<p class="firstline">Lists the billing accounts that the current authenticated user has permission to [view](https://cloud.google.com/billing/docs/how-to/billing-access).</p>
86+
<p class="toc_element">
87+
<code><a href="#list_next">list_next()</a></code></p>
88+
<p class="firstline">Retrieves the next page of results.</p>
89+
<h3>Method Details</h3>
90+
<div class="method">
91+
<code class="details" id="close">close()</code>
92+
<pre>Close httplib2 connections.</pre>
93+
</div>
94+
95+
<div class="method">
96+
<code class="details" id="create">create(parent, body=None, x__xgafv=None)</code>
97+
<pre>This method creates [billing subaccounts](https://cloud.google.com/billing/docs/concepts#subaccounts). Google Cloud resellers should use the Channel Services APIs, [accounts.customers.create](https://cloud.google.com/channel/docs/reference/rest/v1/accounts.customers/create) and [accounts.customers.entitlements.create](https://cloud.google.com/channel/docs/reference/rest/v1/accounts.customers.entitlements/create). When creating a subaccount, the current authenticated user must have the `billing.accounts.update` IAM permission on the parent account, which is typically given to billing account [administrators](https://cloud.google.com/billing/docs/how-to/billing-access). This method will return an error if the parent account has not been provisioned for subaccounts.
98+
99+
Args:
100+
parent: string, Optional. The parent to create a billing account from. Format: - organizations/{organization_id} eg organizations/12345678 - billingAccounts/{billing_account_id} eg `billingAccounts/012345-567890-ABCDEF` (required)
101+
body: object, The request body.
102+
The object takes the form of:
103+
104+
{ # A billing account in the [Google Cloud Console](https://console.cloud.google.com/). You can assign a billing account to one or more projects.
105+
&quot;displayName&quot;: &quot;A String&quot;, # The display name given to the billing account, such as `My Billing Account`. This name is displayed in the Google Cloud Console.
106+
&quot;masterBillingAccount&quot;: &quot;A String&quot;, # If this account is a [subaccount](https://cloud.google.com/billing/docs/concepts), then this will be the resource name of the parent billing account that it is being resold through. Otherwise this will be empty.
107+
&quot;name&quot;: &quot;A String&quot;, # Output only. The resource name of the billing account. The resource name has the form `billingAccounts/{billing_account_id}`. For example, `billingAccounts/012345-567890-ABCDEF` would be the resource name for billing account `012345-567890-ABCDEF`.
108+
&quot;open&quot;: True or False, # Output only. True if the billing account is open, and will therefore be charged for any usage on associated projects. False if the billing account is closed, and therefore projects associated with it will be unable to use paid services.
109+
}
110+
111+
x__xgafv: string, V1 error format.
112+
Allowed values
113+
1 - v1 error format
114+
2 - v2 error format
115+
116+
Returns:
117+
An object of the form:
118+
119+
{ # A billing account in the [Google Cloud Console](https://console.cloud.google.com/). You can assign a billing account to one or more projects.
120+
&quot;displayName&quot;: &quot;A String&quot;, # The display name given to the billing account, such as `My Billing Account`. This name is displayed in the Google Cloud Console.
121+
&quot;masterBillingAccount&quot;: &quot;A String&quot;, # If this account is a [subaccount](https://cloud.google.com/billing/docs/concepts), then this will be the resource name of the parent billing account that it is being resold through. Otherwise this will be empty.
122+
&quot;name&quot;: &quot;A String&quot;, # Output only. The resource name of the billing account. The resource name has the form `billingAccounts/{billing_account_id}`. For example, `billingAccounts/012345-567890-ABCDEF` would be the resource name for billing account `012345-567890-ABCDEF`.
123+
&quot;open&quot;: True or False, # Output only. True if the billing account is open, and will therefore be charged for any usage on associated projects. False if the billing account is closed, and therefore projects associated with it will be unable to use paid services.
124+
}</pre>
125+
</div>
126+
127+
<div class="method">
128+
<code class="details" id="list">list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)</code>
129+
<pre>Lists the billing accounts that the current authenticated user has permission to [view](https://cloud.google.com/billing/docs/how-to/billing-access).
130+
131+
Args:
132+
parent: string, Optional. The parent resource to list billing accounts from. Format: - organizations/{organization_id} eg organizations/12345678 - billingAccounts/{billing_account_id} eg `billingAccounts/012345-567890-ABCDEF` (required)
133+
filter: string, Options for how to filter the returned billing accounts. This only supports filtering for [subaccounts](https://cloud.google.com/billing/docs/concepts) under a single provided parent billing account. (e.g. &quot;master_billing_account=billingAccounts/012345-678901-ABCDEF&quot;). Boolean algebra and other fields are not currently supported.
134+
pageSize: integer, Requested page size. The maximum page size is 100; this is also the default.
135+
pageToken: string, A token identifying a page of results to return. This should be a `next_page_token` value returned from a previous `ListBillingAccounts` call. If unspecified, the first page of results is returned.
136+
x__xgafv: string, V1 error format.
137+
Allowed values
138+
1 - v1 error format
139+
2 - v2 error format
140+
141+
Returns:
142+
An object of the form:
143+
144+
{ # Response message for `ListBillingAccounts`.
145+
&quot;billingAccounts&quot;: [ # A list of billing accounts.
146+
{ # A billing account in the [Google Cloud Console](https://console.cloud.google.com/). You can assign a billing account to one or more projects.
147+
&quot;displayName&quot;: &quot;A String&quot;, # The display name given to the billing account, such as `My Billing Account`. This name is displayed in the Google Cloud Console.
148+
&quot;masterBillingAccount&quot;: &quot;A String&quot;, # If this account is a [subaccount](https://cloud.google.com/billing/docs/concepts), then this will be the resource name of the parent billing account that it is being resold through. Otherwise this will be empty.
149+
&quot;name&quot;: &quot;A String&quot;, # Output only. The resource name of the billing account. The resource name has the form `billingAccounts/{billing_account_id}`. For example, `billingAccounts/012345-567890-ABCDEF` would be the resource name for billing account `012345-567890-ABCDEF`.
150+
&quot;open&quot;: True or False, # Output only. True if the billing account is open, and will therefore be charged for any usage on associated projects. False if the billing account is closed, and therefore projects associated with it will be unable to use paid services.
151+
},
152+
],
153+
&quot;nextPageToken&quot;: &quot;A String&quot;, # A token to retrieve the next page of results. To retrieve the next page, call `ListBillingAccounts` again with the `page_token` field set to this value. This field is empty if there are no more results to retrieve.
154+
}</pre>
155+
</div>
156+
157+
<div class="method">
158+
<code class="details" id="list_next">list_next()</code>
159+
<pre>Retrieves the next page of results.
160+
161+
Args:
162+
previous_request: The request for the previous page. (required)
163+
previous_response: The response from the request for the previous page. (required)
164+
165+
Returns:
166+
A request object that you can call &#x27;execute()&#x27; on to request the next
167+
page. Returns None if there are no more items in the collection.
168+
</pre>
169+
</div>
170+
171+
</body></html>

docs/dyn/cloudbilling_v1.html

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -79,6 +79,11 @@ <h2>Instance Methods</h2>
7979
</p>
8080
<p class="firstline">Returns the billingAccounts Resource.</p>
8181

82+
<p class="toc_element">
83+
<code><a href="cloudbilling_v1.organizations.html">organizations()</a></code>
84+
</p>
85+
<p class="firstline">Returns the organizations Resource.</p>
86+
8287
<p class="toc_element">
8388
<code><a href="cloudbilling_v1.projects.html">projects()</a></code>
8489
</p>

0 commit comments

Comments
 (0)