/
apigee_v1.organizations.environments.apis.deployments.html
171 lines (151 loc) 路 8.16 KB
/
apigee_v1.organizations.environments.apis.deployments.html
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
<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.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="#list">list(parent, x__xgafv=None)</a></code></p>
<p class="firstline">Lists all deployments of an API proxy in an environment.</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="list">list(parent, x__xgafv=None)</code>
<pre>Lists all deployments of an API proxy in an environment.
Args:
parent: string, Required. Name representing an API proxy in an environment in the following format: `organizations/{org}/environments/{env}/apis/{api}` (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{
"deployments": [ # List of deployments.
{
"apiProxy": "A String", # API proxy.
"deployStartTime": "A String", # Time the API proxy was marked `deployed` in the control plane in millisconds since epoch.
"environment": "A String", # Environment.
"errors": [ # Errors reported for this deployment. Populated only when state == ERROR. This field is not populated in List APIs.
{ # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).
"code": 42, # The status code, which should be an enum value of google.rpc.Code.
"details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
{
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
"message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
},
],
"instances": [ # Status reported by each runtime instance. This field is not populated in List APIs.
{ # The status of a deployment as reported by a single instance.
"deployedRevisions": [ # Revisions currently deployed in MPs.
{ # Revisions deployed in the MPs.
"percentage": 42, # Percentage of MP replicas reporting this revision.
"revision": "A String", # API proxy revision reported as deployed.
},
],
"deployedRoutes": [ # Current routes deployed in the ingress routing table. A route which is missing will appear in `missing_routes`.
{ # Route deployed in the ingress routing table.
"basepath": "A String", # Base path in the routing table.
"envgroup": "A String", # Environment group where this route is installed.
"environment": "A String", # Destination environment. This will be empty if the route is not yet reported.
"percentage": 42, # Percentage of ingress replicas reporting this route.
},
],
"instance": "A String", # ID of the instance reporting the status.
},
],
"pods": [ # Status reported by runtime pods. This field is not populated for List APIs. **Note**: **This field is deprecated**. Runtime versions 1.3 and above report instance level status rather than pod status.
{
"appVersion": "A String", # Version of the application running in the pod.
"deploymentStatus": "A String", # Status of the deployment. Valid values include: - `deployed`: Successful. - `error` : Failed. - `pending` : Pod has not yet reported on the deployment.
"deploymentStatusTime": "A String", # Time the deployment status was reported in milliseconds since epoch.
"deploymentTime": "A String", # Time the proxy was deployed in milliseconds since epoch.
"podName": "A String", # Name of the pod which is reporting the status.
"podStatus": "A String", # Overall status of the pod (not this specific deployment). Valid values include: - `active`: Up to date. - `stale` : Recently out of date. Pods that have not reported status in a long time are excluded from the output.
"podStatusTime": "A String", # Time the pod status was reported in milliseconds since epoch.
"statusCode": "A String", # Code associated with the deployment status.
"statusCodeDetails": "A String", # Human-readable message associated with the status code.
},
],
"revision": "A String", # API proxy revision.
"routeConflicts": [ # Conflicts in the desired state routing configuration. The presence of conflicts does not cause the state to be `ERROR`, but it will mean that some of the deployment's base paths are not routed to its environment. If the conflicts change, the state will transition to `PROGRESSING` until the latest configuration is rolled out to all instances. This field is not populated in List APIs.
{ # 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.
},
],
"state": "A String", # Current state of the deployment. This field is not populated in List APIs.
},
],
}</pre>
</div>
</body></html>