1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
|
<html><body>
<style>
body, h1, h2, h3, div, span, p, pre, a {
margin: 0;
padding: 0;
border: 0;
font-weight: inherit;
font-style: inherit;
font-size: 100%;
font-family: inherit;
vertical-align: baseline;
}
body {
font-size: 13px;
padding: 1em;
}
h1 {
font-size: 26px;
margin-bottom: 1em;
}
h2 {
font-size: 24px;
margin-bottom: 1em;
}
h3 {
font-size: 20px;
margin-bottom: 1em;
margin-top: 1em;
}
pre, code {
line-height: 1.5;
font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
}
pre {
margin-top: 0.5em;
}
h1, h2, h3, p {
font-family: Arial, sans serif;
}
h1, h2, h3 {
border-bottom: solid #CCC 1px;
}
.toc_element {
margin-top: 0.5em;
}
.firstline {
margin-left: 2 em;
}
.method {
margin-top: 1em;
border: solid 1px #CCC;
padding: 1em;
background: #EEE;
}
.details {
font-weight: bold;
font-size: 14px;
}
</style>
<h1><a href="apigee_v1.html">Apigee API</a> . <a href="apigee_v1.organizations.html">organizations</a> . <a href="apigee_v1.organizations.apis.html">apis</a> . <a href="apigee_v1.organizations.apis.revisions.html">revisions</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
<code><a href="apigee_v1.organizations.apis.revisions.deployments.html">deployments()</a></code>
</p>
<p class="firstline">Returns the deployments Resource.</p>
<p class="toc_element">
<code><a href="#close">close()</a></code></p>
<p class="firstline">Close httplib2 connections.</p>
<p class="toc_element">
<code><a href="#delete">delete(name, x__xgafv=None)</a></code></p>
<p class="firstline">Deletes an API proxy revision and all policies, resources, endpoints, and revisions associated with it. The API proxy revision must be undeployed before you can delete it.</p>
<p class="toc_element">
<code><a href="#get">get(name, format=None, x__xgafv=None)</a></code></p>
<p class="firstline">Gets an API proxy revision. To download the API proxy configuration bundle for the specified revision as a zip file, set the `format` query parameter to `bundle`. If you are using curl, specify `-o filename.zip` to save the output to a file; otherwise, it displays to `stdout`. Then, develop the API proxy configuration locally and upload the updated API proxy configuration revision, as described in [updateApiProxyRevision](updateApiProxyRevision).</p>
<p class="toc_element">
<code><a href="#updateApiProxyRevision">updateApiProxyRevision(name, body=None, validate=None, x__xgafv=None)</a></code></p>
<p class="firstline">Updates an existing API proxy revision by uploading the API proxy configuration bundle as a zip file from your local machine. You can update only API proxy revisions that have never been deployed. After deployment, an API proxy revision becomes immutable, even if it is undeployed. Set the `Content-Type` header to either `multipart/form-data` or `application/octet-stream`.</p>
<h3>Method Details</h3>
<div class="method">
<code class="details" id="close">close()</code>
<pre>Close httplib2 connections.</pre>
</div>
<div class="method">
<code class="details" id="delete">delete(name, x__xgafv=None)</code>
<pre>Deletes an API proxy revision and all policies, resources, endpoints, and revisions associated with it. The API proxy revision must be undeployed before you can delete it.
Args:
name: string, Required. API proxy revision in the following format: `organizations/{org}/apis/{api}/revisions/{rev}` If the API Proxy resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview). (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # API proxy revision.
"archive": "A String", # Output only. The archive that generated this proxy revision. This field is only present on proxy revisions that were generated by an archive. Proxies generated by archives cannot be updated, deleted, or deployed to other environments. Format: `organizations/*/environments/*/archiveDeployments/*`
"basepaths": [ # Base URL of the API proxy.
"A String",
],
"configurationVersion": { # Version of the API proxy configuration schema. Currently, only 4.0 is supported. # Version of the API proxy configuration schema to which the API proxy conforms. Currently, the only supported value is 4.0 (`majorVersion.minorVersion`). This setting may be used in the future to track the evolution of the API proxy format.
"majorVersion": 42, # Major version of the API proxy configuration schema.
"minorVersion": 42, # Minor version of the API proxy configuration schema.
},
"contextInfo": "A String", # Revision number, app name, and organization for the API proxy.
"createdAt": "A String", # Time that the API proxy revision was created in milliseconds since epoch.
"description": "A String", # Description of the API proxy revision.
"displayName": "A String", # Human-readable name of the API proxy.
"entityMetaDataAsProperties": { # Metadata describing the API proxy revision as a key-value map.
"a_key": "A String",
},
"hasExtensiblePolicy": True or False, # Output only. This field will be marked as true if revision contains any policies marked as extensible.
"integrationEndpoints": [ # List of IntegrationEndpoints in the '/integration-endpoints' directory of the API proxy. This is a 'manifest' setting designed to provide visibility into the contents of the API proxy.
"A String",
],
"lastModifiedAt": "A String", # Time that the API proxy revision was last modified in milliseconds since epoch.
"name": "A String", # Name of the API proxy.
"policies": [ # List of policy names included in the API proxy revision..
"A String",
],
"proxies": [ # List of proxy names included in the API proxy revision.
"A String",
],
"proxyEndpoints": [ # List of ProxyEndpoints in the `/proxies` directory of the API proxy. Typically, this element is included only when the API proxy was created using the Edge UI. This is a 'manifest' setting designed to provide visibility into the contents of the API proxy.
"A String",
],
"resourceFiles": { # List of resource files. # List of resource files included in the API proxy revision.
"resourceFile": [ # List of resource files.
{ # Metadata about a resource file.
"name": "A String", # ID of the resource file.
"type": "A String", # Resource file type. {{ resource_file_type }}
},
],
},
"resources": [ # List of the resources included in the API proxy revision formatted as "{type}://{name}".
"A String",
],
"revision": "A String", # API proxy revision.
"sharedFlows": [ # List of the shared flows included in the API proxy revision.
"A String",
],
"spec": "A String", # OpenAPI Specification that is associated with the API proxy. The value is set to a URL or to a path in the specification store.
"targetEndpoints": [ # List of TargetEndpoints in the `/targets` directory of the API proxy. Typically, this element is included only when the API proxy was created using the Edge UI. This is a 'manifest' setting designed to provide visibility into the contents of the API proxy.
"A String",
],
"targetServers": [ # List of TargetServers referenced in any TargetEndpoint in the API proxy. Typically, you will see this element only when the API proxy was created using the Edge UI. This is a 'manifest' setting designed to provide visibility into the contents of the API proxy.
"A String",
],
"targets": [ # List of the targets included in the API proxy revision.
"A String",
],
"teams": [ # List of the teams included in the API proxy revision.
"A String",
],
"type": "A String", # Type. Set to `Application`. Maintained for compatibility with the Apigee Edge API.
}</pre>
</div>
<div class="method">
<code class="details" id="get">get(name, format=None, x__xgafv=None)</code>
<pre>Gets an API proxy revision. To download the API proxy configuration bundle for the specified revision as a zip file, set the `format` query parameter to `bundle`. If you are using curl, specify `-o filename.zip` to save the output to a file; otherwise, it displays to `stdout`. Then, develop the API proxy configuration locally and upload the updated API proxy configuration revision, as described in [updateApiProxyRevision](updateApiProxyRevision).
Args:
name: string, Required. API proxy revision in the following format: `organizations/{org}/apis/{api}/revisions/{rev}` If the API Proxy resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview). (required)
format: string, Format used when downloading the API proxy configuration revision. Set to `bundle` to download the API proxy configuration revision as a zip file.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Message that represents an arbitrary HTTP body. It should only be used for payload formats that can't be represented as JSON, such as raw binary or an HTML page. This message can be used both in streaming and non-streaming API methods in the request as well as the response. It can be used as a top-level request field, which is convenient if one wants to extract parameters from either the URL or HTTP template into the request fields and also want access to the raw HTTP body. Example: message GetResourceRequest { // A unique request id. string request_id = 1; // The raw HTTP body is bound to this field. google.api.HttpBody http_body = 2; } service ResourceService { rpc GetResource(GetResourceRequest) returns (google.api.HttpBody); rpc UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty); } Example with streaming methods: service CaldavService { rpc GetCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); rpc UpdateCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); } Use of this type only changes how the request and response bodies are handled, all other features will continue to work unchanged.
"contentType": "A String", # The HTTP Content-Type header value specifying the content type of the body.
"data": "A String", # The HTTP request/response body as raw binary.
"extensions": [ # Application specific response metadata. Must be set in the first response for streaming APIs.
{
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
}</pre>
</div>
<div class="method">
<code class="details" id="updateApiProxyRevision">updateApiProxyRevision(name, body=None, validate=None, x__xgafv=None)</code>
<pre>Updates an existing API proxy revision by uploading the API proxy configuration bundle as a zip file from your local machine. You can update only API proxy revisions that have never been deployed. After deployment, an API proxy revision becomes immutable, even if it is undeployed. Set the `Content-Type` header to either `multipart/form-data` or `application/octet-stream`.
Args:
name: string, Required. API proxy revision to update in the following format: `organizations/{org}/apis/{api}/revisions/{rev}` If the API Proxy resource has the `space` attribute set, IAM permissions are checked against the Space resource path. To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview). (required)
body: object, The request body.
The object takes the form of:
{ # Message that represents an arbitrary HTTP body. It should only be used for payload formats that can't be represented as JSON, such as raw binary or an HTML page. This message can be used both in streaming and non-streaming API methods in the request as well as the response. It can be used as a top-level request field, which is convenient if one wants to extract parameters from either the URL or HTTP template into the request fields and also want access to the raw HTTP body. Example: message GetResourceRequest { // A unique request id. string request_id = 1; // The raw HTTP body is bound to this field. google.api.HttpBody http_body = 2; } service ResourceService { rpc GetResource(GetResourceRequest) returns (google.api.HttpBody); rpc UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty); } Example with streaming methods: service CaldavService { rpc GetCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); rpc UpdateCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); } Use of this type only changes how the request and response bodies are handled, all other features will continue to work unchanged.
"contentType": "A String", # The HTTP Content-Type header value specifying the content type of the body.
"data": "A String", # The HTTP request/response body as raw binary.
"extensions": [ # Application specific response metadata. Must be set in the first response for streaming APIs.
{
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
}
validate: boolean, Ignored. All uploads are validated regardless of the value of this field. Maintained for compatibility with Apigee Edge API.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # API proxy revision.
"archive": "A String", # Output only. The archive that generated this proxy revision. This field is only present on proxy revisions that were generated by an archive. Proxies generated by archives cannot be updated, deleted, or deployed to other environments. Format: `organizations/*/environments/*/archiveDeployments/*`
"basepaths": [ # Base URL of the API proxy.
"A String",
],
"configurationVersion": { # Version of the API proxy configuration schema. Currently, only 4.0 is supported. # Version of the API proxy configuration schema to which the API proxy conforms. Currently, the only supported value is 4.0 (`majorVersion.minorVersion`). This setting may be used in the future to track the evolution of the API proxy format.
"majorVersion": 42, # Major version of the API proxy configuration schema.
"minorVersion": 42, # Minor version of the API proxy configuration schema.
},
"contextInfo": "A String", # Revision number, app name, and organization for the API proxy.
"createdAt": "A String", # Time that the API proxy revision was created in milliseconds since epoch.
"description": "A String", # Description of the API proxy revision.
"displayName": "A String", # Human-readable name of the API proxy.
"entityMetaDataAsProperties": { # Metadata describing the API proxy revision as a key-value map.
"a_key": "A String",
},
"hasExtensiblePolicy": True or False, # Output only. This field will be marked as true if revision contains any policies marked as extensible.
"integrationEndpoints": [ # List of IntegrationEndpoints in the '/integration-endpoints' directory of the API proxy. This is a 'manifest' setting designed to provide visibility into the contents of the API proxy.
"A String",
],
"lastModifiedAt": "A String", # Time that the API proxy revision was last modified in milliseconds since epoch.
"name": "A String", # Name of the API proxy.
"policies": [ # List of policy names included in the API proxy revision..
"A String",
],
"proxies": [ # List of proxy names included in the API proxy revision.
"A String",
],
"proxyEndpoints": [ # List of ProxyEndpoints in the `/proxies` directory of the API proxy. Typically, this element is included only when the API proxy was created using the Edge UI. This is a 'manifest' setting designed to provide visibility into the contents of the API proxy.
"A String",
],
"resourceFiles": { # List of resource files. # List of resource files included in the API proxy revision.
"resourceFile": [ # List of resource files.
{ # Metadata about a resource file.
"name": "A String", # ID of the resource file.
"type": "A String", # Resource file type. {{ resource_file_type }}
},
],
},
"resources": [ # List of the resources included in the API proxy revision formatted as "{type}://{name}".
"A String",
],
"revision": "A String", # API proxy revision.
"sharedFlows": [ # List of the shared flows included in the API proxy revision.
"A String",
],
"spec": "A String", # OpenAPI Specification that is associated with the API proxy. The value is set to a URL or to a path in the specification store.
"targetEndpoints": [ # List of TargetEndpoints in the `/targets` directory of the API proxy. Typically, this element is included only when the API proxy was created using the Edge UI. This is a 'manifest' setting designed to provide visibility into the contents of the API proxy.
"A String",
],
"targetServers": [ # List of TargetServers referenced in any TargetEndpoint in the API proxy. Typically, you will see this element only when the API proxy was created using the Edge UI. This is a 'manifest' setting designed to provide visibility into the contents of the API proxy.
"A String",
],
"targets": [ # List of the targets included in the API proxy revision.
"A String",
],
"teams": [ # List of the teams included in the API proxy revision.
"A String",
],
"type": "A String", # Type. Set to `Application`. Maintained for compatibility with the Apigee Edge API.
}</pre>
</div>
</body></html>
|
