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
|
<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.environments.html">environments</a> . <a href="apigee_v1.organizations.environments.apis.html">apis</a> . <a href="apigee_v1.organizations.environments.apis.revisions.html">revisions</a> . <a href="apigee_v1.organizations.environments.apis.revisions.deployments.html">deployments</a></h1>
<h2>Instance Methods</h2>
<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="#generateDeployChangeReport">generateDeployChangeReport(name, override=None, x__xgafv=None)</a></code></p>
<p class="firstline">Generates a report for a dry run analysis of a DeployApiProxy request without committing the deployment. In addition to the standard validations performed when adding deployments, additional analysis will be done to detect possible traffic routing changes that would result from this deployment being created. Any potential routing conflicts or unsafe changes will be reported in the response. This routing analysis is not performed for a non-dry-run DeployApiProxy request. For a request path `organizations/{org}/environments/{env}/apis/{api}/revisions/{rev}/deployments:generateDeployChangeReport`, two permissions are required: * `apigee.deployments.create` on the resource `organizations/{org}/environments/{env}` * `apigee.proxyrevisions.deploy` on the resource `organizations/{org}/apis/{api}/revisions/{rev}`</p>
<p class="toc_element">
<code><a href="#generateUndeployChangeReport">generateUndeployChangeReport(name, x__xgafv=None)</a></code></p>
<p class="firstline">Generates a report for a dry run analysis of an UndeployApiProxy request without committing the undeploy. In addition to the standard validations performed when removing deployments, additional analysis will be done to detect possible traffic routing changes that would result from this deployment being removed. Any potential routing conflicts or unsafe changes will be reported in the response. This routing analysis is not performed for a non-dry-run UndeployApiProxy request. For a request path `organizations/{org}/environments/{env}/apis/{api}/revisions/{rev}/deployments:generateUndeployChangeReport`, two permissions are required: * `apigee.deployments.delete` on the resource `organizations/{org}/environments/{env}` * `apigee.proxyrevisions.undeploy` on the resource `organizations/{org}/apis/{api}/revisions/{rev}`</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="generateDeployChangeReport">generateDeployChangeReport(name, override=None, x__xgafv=None)</code>
<pre>Generates a report for a dry run analysis of a DeployApiProxy request without committing the deployment. In addition to the standard validations performed when adding deployments, additional analysis will be done to detect possible traffic routing changes that would result from this deployment being created. Any potential routing conflicts or unsafe changes will be reported in the response. This routing analysis is not performed for a non-dry-run DeployApiProxy request. For a request path `organizations/{org}/environments/{env}/apis/{api}/revisions/{rev}/deployments:generateDeployChangeReport`, two permissions are required: * `apigee.deployments.create` on the resource `organizations/{org}/environments/{env}` * `apigee.proxyrevisions.deploy` on the resource `organizations/{org}/apis/{api}/revisions/{rev}`
Args:
name: string, Name of the API proxy revision deployment in the following format: `organizations/{org}/environments/{env}/apis/{api}/revisions/{rev}` If the API proxy resource has the `space` attribute set, IAM permissions are checked differently . To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview). (required)
override: boolean, Flag that specifies whether to force the deployment of the new revision over the currently deployed revision by overriding conflict checks.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Response for GenerateDeployChangeReport and GenerateUndeployChangeReport. This report contains any validation failures that would cause the deployment to be rejected, as well changes and conflicts in routing that may occur due to the new deployment. The existence of a routing warning does not necessarily imply that the deployment request is bad, if the desired state of the deployment request is to effect a routing change. The primary purposes of the routing messages are: 1) To inform users of routing changes that may have an effect on traffic currently being routed to other existing deployments. 2) To warn users if some base path in the proxy will not receive traffic due to an existing deployment having already claimed that base path. The presence of routing conflicts/changes will not cause non-dry-run DeployApiProxy/UndeployApiProxy requests to be rejected.
"routingChanges": [ # All routing changes that may result from a deployment request.
{ # Describes a potential routing change that may occur as a result of some deployment operation.
"description": "A String", # Human-readable description of this routing change.
"environmentGroup": "A String", # Name of the environment group affected by this routing change.
"fromDeployment": { # Tuple representing a base path and the deployment containing it. # Base path/deployment that may stop receiving some traffic.
"apiProxy": "A String", # Name of the deployed API proxy revision containing the base path.
"basepath": "A String", # Base path receiving traffic.
"environment": "A String", # Name of the environment in which the proxy is deployed.
"revision": "A String", # Name of the deployed API proxy revision containing the base path.
},
"shouldSequenceRollout": True or False, # Set to `true` if using sequenced rollout would make this routing change safer. **Note**: This does not necessarily imply that automated sequenced rollout mode is supported for the operation.
"toDeployment": { # Tuple representing a base path and the deployment containing it. # Base path/deployment that may start receiving that traffic. May be null if no deployment is able to receive the traffic.
"apiProxy": "A String", # Name of the deployed API proxy revision containing the base path.
"basepath": "A String", # Base path receiving traffic.
"environment": "A String", # Name of the environment in which the proxy is deployed.
"revision": "A String", # Name of the deployed API proxy revision containing the base path.
},
},
],
"routingConflicts": [ # All base path conflicts detected for a deployment request.
{ # Describes a routing conflict that may cause a deployment not to receive traffic at some base path.
"conflictingDeployment": { # Tuple representing a base path and the deployment containing it. # Existing base path/deployment causing the conflict.
"apiProxy": "A String", # Name of the deployed API proxy revision containing the base path.
"basepath": "A String", # Base path receiving traffic.
"environment": "A String", # Name of the environment in which the proxy is deployed.
"revision": "A String", # Name of the deployed API proxy revision containing the base path.
},
"description": "A String", # Human-readable description of this conflict.
"environmentGroup": "A String", # Name of the environment group in which this conflict exists.
},
],
"validationErrors": { # Describes what preconditions have failed. For example, if an RPC failed because it required the Terms of Service to be acknowledged, it could list the terms of service violation in the PreconditionFailure message. # Validation errors that would cause the deployment change request to be rejected.
"violations": [ # Describes all precondition violations.
{ # A message type used to describe a single precondition failure.
"description": "A String", # A description of how the precondition failed. Developers can use this description to understand how to fix the failure. For example: "Terms of service not accepted".
"subject": "A String", # The subject, relative to the type, that failed. For example, "google.com/cloud" relative to the "TOS" type would indicate which terms of service is being referenced.
"type": "A String", # The type of PreconditionFailure. We recommend using a service-specific enum type to define the supported precondition violation subjects. For example, "TOS" for "Terms of Service violation".
},
],
},
}</pre>
</div>
<div class="method">
<code class="details" id="generateUndeployChangeReport">generateUndeployChangeReport(name, x__xgafv=None)</code>
<pre>Generates a report for a dry run analysis of an UndeployApiProxy request without committing the undeploy. In addition to the standard validations performed when removing deployments, additional analysis will be done to detect possible traffic routing changes that would result from this deployment being removed. Any potential routing conflicts or unsafe changes will be reported in the response. This routing analysis is not performed for a non-dry-run UndeployApiProxy request. For a request path `organizations/{org}/environments/{env}/apis/{api}/revisions/{rev}/deployments:generateUndeployChangeReport`, two permissions are required: * `apigee.deployments.delete` on the resource `organizations/{org}/environments/{env}` * `apigee.proxyrevisions.undeploy` on the resource `organizations/{org}/apis/{api}/revisions/{rev}`
Args:
name: string, Name of the API proxy revision deployment in the following format: `organizations/{org}/environments/{env}/apis/{api}/revisions/{rev}` (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Response for GenerateDeployChangeReport and GenerateUndeployChangeReport. This report contains any validation failures that would cause the deployment to be rejected, as well changes and conflicts in routing that may occur due to the new deployment. The existence of a routing warning does not necessarily imply that the deployment request is bad, if the desired state of the deployment request is to effect a routing change. The primary purposes of the routing messages are: 1) To inform users of routing changes that may have an effect on traffic currently being routed to other existing deployments. 2) To warn users if some base path in the proxy will not receive traffic due to an existing deployment having already claimed that base path. The presence of routing conflicts/changes will not cause non-dry-run DeployApiProxy/UndeployApiProxy requests to be rejected.
"routingChanges": [ # All routing changes that may result from a deployment request.
{ # Describes a potential routing change that may occur as a result of some deployment operation.
"description": "A String", # Human-readable description of this routing change.
"environmentGroup": "A String", # Name of the environment group affected by this routing change.
"fromDeployment": { # Tuple representing a base path and the deployment containing it. # Base path/deployment that may stop receiving some traffic.
"apiProxy": "A String", # Name of the deployed API proxy revision containing the base path.
"basepath": "A String", # Base path receiving traffic.
"environment": "A String", # Name of the environment in which the proxy is deployed.
"revision": "A String", # Name of the deployed API proxy revision containing the base path.
},
"shouldSequenceRollout": True or False, # Set to `true` if using sequenced rollout would make this routing change safer. **Note**: This does not necessarily imply that automated sequenced rollout mode is supported for the operation.
"toDeployment": { # Tuple representing a base path and the deployment containing it. # Base path/deployment that may start receiving that traffic. May be null if no deployment is able to receive the traffic.
"apiProxy": "A String", # Name of the deployed API proxy revision containing the base path.
"basepath": "A String", # Base path receiving traffic.
"environment": "A String", # Name of the environment in which the proxy is deployed.
"revision": "A String", # Name of the deployed API proxy revision containing the base path.
},
},
],
"routingConflicts": [ # All base path conflicts detected for a deployment request.
{ # Describes a routing conflict that may cause a deployment not to receive traffic at some base path.
"conflictingDeployment": { # Tuple representing a base path and the deployment containing it. # Existing base path/deployment causing the conflict.
"apiProxy": "A String", # Name of the deployed API proxy revision containing the base path.
"basepath": "A String", # Base path receiving traffic.
"environment": "A String", # Name of the environment in which the proxy is deployed.
"revision": "A String", # Name of the deployed API proxy revision containing the base path.
},
"description": "A String", # Human-readable description of this conflict.
"environmentGroup": "A String", # Name of the environment group in which this conflict exists.
},
],
"validationErrors": { # Describes what preconditions have failed. For example, if an RPC failed because it required the Terms of Service to be acknowledged, it could list the terms of service violation in the PreconditionFailure message. # Validation errors that would cause the deployment change request to be rejected.
"violations": [ # Describes all precondition violations.
{ # A message type used to describe a single precondition failure.
"description": "A String", # A description of how the precondition failed. Developers can use this description to understand how to fix the failure. For example: "Terms of service not accepted".
"subject": "A String", # The subject, relative to the type, that failed. For example, "google.com/cloud" relative to the "TOS" type would indicate which terms of service is being referenced.
"type": "A String", # The type of PreconditionFailure. We recommend using a service-specific enum type to define the supported precondition violation subjects. For example, "TOS" for "Terms of Service violation".
},
],
},
}</pre>
</div>
</body></html>
|
