• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1{
2  "version":"2.0",
3  "metadata":{
4    "apiVersion":"2023-01-25",
5    "endpointPrefix":"deployment-marketplace",
6    "jsonVersion":"1.1",
7    "protocol":"rest-json",
8    "serviceFullName":"AWS Marketplace Deployment Service",
9    "serviceId":"Marketplace Deployment",
10    "signatureVersion":"v4",
11    "signingName":"aws-marketplace",
12    "uid":"marketplace-deployment-2023-01-25"
13  },
14  "operations":{
15    "ListTagsForResource":{
16      "name":"ListTagsForResource",
17      "http":{
18        "method":"GET",
19        "requestUri":"/tags/{resourceArn}",
20        "responseCode":200
21      },
22      "input":{"shape":"ListTagsForResourceRequest"},
23      "output":{"shape":"ListTagsForResourceResponse"},
24      "errors":[
25        {"shape":"ThrottlingException"},
26        {"shape":"AccessDeniedException"},
27        {"shape":"ResourceNotFoundException"},
28        {"shape":"ValidationException"},
29        {"shape":"InternalServerException"}
30      ],
31      "documentation":"<p>Lists all tags that have been added to a deployment parameter resource.</p>"
32    },
33    "PutDeploymentParameter":{
34      "name":"PutDeploymentParameter",
35      "http":{
36        "method":"POST",
37        "requestUri":"/catalogs/{catalog}/products/{productId}/deployment-parameters",
38        "responseCode":200
39      },
40      "input":{"shape":"PutDeploymentParameterRequest"},
41      "output":{"shape":"PutDeploymentParameterResponse"},
42      "errors":[
43        {"shape":"ThrottlingException"},
44        {"shape":"AccessDeniedException"},
45        {"shape":"ResourceNotFoundException"},
46        {"shape":"ServiceQuotaExceededException"},
47        {"shape":"ConflictException"},
48        {"shape":"ValidationException"},
49        {"shape":"InternalServerException"}
50      ],
51      "documentation":"<p>Creates or updates a deployment parameter and is targeted by <code>catalog</code> and <code>agreementId</code>.</p>",
52      "idempotent":true
53    },
54    "TagResource":{
55      "name":"TagResource",
56      "http":{
57        "method":"POST",
58        "requestUri":"/tags/{resourceArn}",
59        "responseCode":204
60      },
61      "input":{"shape":"TagResourceRequest"},
62      "output":{"shape":"TagResourceResponse"},
63      "errors":[
64        {"shape":"ThrottlingException"},
65        {"shape":"AccessDeniedException"},
66        {"shape":"ResourceNotFoundException"},
67        {"shape":"ConflictException"},
68        {"shape":"ValidationException"},
69        {"shape":"InternalServerException"}
70      ],
71      "documentation":"<p>Tags a resource.</p>"
72    },
73    "UntagResource":{
74      "name":"UntagResource",
75      "http":{
76        "method":"DELETE",
77        "requestUri":"/tags/{resourceArn}",
78        "responseCode":204
79      },
80      "input":{"shape":"UntagResourceRequest"},
81      "output":{"shape":"UntagResourceResponse"},
82      "errors":[
83        {"shape":"ThrottlingException"},
84        {"shape":"AccessDeniedException"},
85        {"shape":"ResourceNotFoundException"},
86        {"shape":"ConflictException"},
87        {"shape":"ValidationException"},
88        {"shape":"InternalServerException"}
89      ],
90      "documentation":"<p>Removes a tag or list of tags from a resource.</p>",
91      "idempotent":true
92    }
93  },
94  "shapes":{
95    "AccessDeniedException":{
96      "type":"structure",
97      "required":["message"],
98      "members":{
99        "message":{"shape":"String"}
100      },
101      "documentation":"<p>You do not have sufficient access to perform this action.</p>",
102      "error":{
103        "httpStatusCode":403,
104        "senderFault":true
105      },
106      "exception":true
107    },
108    "Catalog":{
109      "type":"string",
110      "max":64,
111      "min":1,
112      "pattern":"^[a-zA-Z_-]+$"
113    },
114    "ClientToken":{
115      "type":"string",
116      "max":64,
117      "min":32,
118      "pattern":"^[a-zA-Z0-9/_+=.:@-]+$"
119    },
120    "ConflictException":{
121      "type":"structure",
122      "required":[
123        "message",
124        "resourceId"
125      ],
126      "members":{
127        "message":{"shape":"String"},
128        "resourceId":{
129          "shape":"ResourceId",
130          "documentation":"<p>The unique identifier for the resource associated with the error.</p>"
131        }
132      },
133      "documentation":"<p>The request configuration has conflicts. For details, see the accompanying error message.</p>",
134      "error":{
135        "httpStatusCode":409,
136        "senderFault":true
137      },
138      "exception":true
139    },
140    "DeploymentParameterInput":{
141      "type":"structure",
142      "required":[
143        "name",
144        "secretString"
145      ],
146      "members":{
147        "name":{
148          "shape":"DeploymentParameterName",
149          "documentation":"<p>The desired name of the deployment parameter. This is the identifier on which deployment parameters are keyed for a given buyer and product. If this name matches an existing deployment parameter, this request will update the existing resource.</p>"
150        },
151        "secretString":{
152          "shape":"SecretString",
153          "documentation":"<p>The text to encrypt and store in the secret.</p>"
154        }
155      },
156      "documentation":"<p>The shape containing the requested deployment parameter name and secretString.</p>"
157    },
158    "DeploymentParameterName":{
159      "type":"string",
160      "max":400,
161      "min":1,
162      "pattern":"^[a-zA-Z0-9/_+=.@-]+$"
163    },
164    "DeploymentParameterResourceIdentifier":{
165      "type":"string",
166      "max":32,
167      "min":1,
168      "pattern":"^dp-[a-zA-Z0-9]+$"
169    },
170    "InternalServerException":{
171      "type":"structure",
172      "required":["message"],
173      "members":{
174        "message":{"shape":"String"}
175      },
176      "documentation":"<p>There was an internal service exception.</p>",
177      "error":{"httpStatusCode":500},
178      "exception":true,
179      "fault":true,
180      "retryable":{"throttling":false}
181    },
182    "ListTagsForResourceRequest":{
183      "type":"structure",
184      "required":["resourceArn"],
185      "members":{
186        "resourceArn":{
187          "shape":"String",
188          "documentation":"<p>The Amazon Resource Name (ARN) associated with the deployment parameter resource you want to list tags on.</p>",
189          "location":"uri",
190          "locationName":"resourceArn"
191        }
192      }
193    },
194    "ListTagsForResourceResponse":{
195      "type":"structure",
196      "members":{
197        "tags":{
198          "shape":"Tags",
199          "documentation":"<p>A map of key-value pairs, where each pair represents a tag present on the resource.</p>"
200        }
201      }
202    },
203    "PutDeploymentParameterRequest":{
204      "type":"structure",
205      "required":[
206        "agreementId",
207        "catalog",
208        "deploymentParameter",
209        "productId"
210      ],
211      "members":{
212        "agreementId":{
213          "shape":"ResourceId",
214          "documentation":"<p>The unique identifier of the agreement.</p>"
215        },
216        "catalog":{
217          "shape":"Catalog",
218          "documentation":"<p>The catalog related to the request. Fixed value: <code>AWS Marketplace</code> </p>",
219          "location":"uri",
220          "locationName":"catalog"
221        },
222        "clientToken":{
223          "shape":"ClientToken",
224          "documentation":"<p>The idempotency token for deployment parameters. A unique identifier for the new version.</p>",
225          "idempotencyToken":true
226        },
227        "deploymentParameter":{
228          "shape":"DeploymentParameterInput",
229          "documentation":"<p>The deployment parameter targeted to the acceptor of an agreement for which to create the AWS Secret Manager resource.</p>"
230        },
231        "expirationDate":{
232          "shape":"SyntheticTimestamp_date_time",
233          "documentation":"<p>The date when deployment parameters expire and are scheduled for deletion.</p>"
234        },
235        "productId":{
236          "shape":"ResourceId",
237          "documentation":"<p>The product for which AWS Marketplace will save secrets for the buyer’s account.</p>",
238          "location":"uri",
239          "locationName":"productId"
240        },
241        "tags":{
242          "shape":"TagsMap",
243          "documentation":"<p>A map of key-value pairs, where each pair represents a tag saved to the resource. Tags will only be applied for create operations, and they'll be ignored if the resource already exists.</p>"
244        }
245      }
246    },
247    "PutDeploymentParameterResponse":{
248      "type":"structure",
249      "required":[
250        "agreementId",
251        "deploymentParameterId",
252        "resourceArn"
253      ],
254      "members":{
255        "agreementId":{
256          "shape":"ResourceId",
257          "documentation":"<p>The unique identifier of the agreement.</p>"
258        },
259        "deploymentParameterId":{
260          "shape":"DeploymentParameterResourceIdentifier",
261          "documentation":"<p>The unique identifier of the deployment parameter.</p>"
262        },
263        "resourceArn":{
264          "shape":"ResourceArn",
265          "documentation":"<p>The Amazon Resource Name (ARN) associated with the deployment parameter resource you want to create or update.</p>"
266        },
267        "tags":{
268          "shape":"TagsMap",
269          "documentation":"<p>A map of key-value pairs, where each pair represents a tag saved to the resource. Tags will only be applied for create operations, and they'll be ignored if the resource already exists.</p>"
270        }
271      }
272    },
273    "ResourceArn":{
274      "type":"string",
275      "max":2048,
276      "min":1,
277      "pattern":"^[a-zA-Z0-9:*/-]+$"
278    },
279    "ResourceId":{
280      "type":"string",
281      "max":64,
282      "min":1,
283      "pattern":"^[A-Za-z0-9_/-]+$"
284    },
285    "ResourceNotFoundException":{
286      "type":"structure",
287      "required":["message"],
288      "members":{
289        "message":{"shape":"String"}
290      },
291      "documentation":"<p>The specified resource wasn't found.</p>",
292      "error":{
293        "httpStatusCode":404,
294        "senderFault":true
295      },
296      "exception":true
297    },
298    "SecretString":{
299      "type":"string",
300      "max":15000,
301      "min":1,
302      "sensitive":true
303    },
304    "ServiceQuotaExceededException":{
305      "type":"structure",
306      "required":["message"],
307      "members":{
308        "message":{"shape":"String"}
309      },
310      "documentation":"<p>The maximum number of requests per account has been exceeded.</p>",
311      "error":{
312        "httpStatusCode":402,
313        "senderFault":true
314      },
315      "exception":true
316    },
317    "String":{"type":"string"},
318    "StringList":{
319      "type":"list",
320      "member":{"shape":"String"}
321    },
322    "SyntheticTimestamp_date_time":{
323      "type":"timestamp",
324      "timestampFormat":"iso8601"
325    },
326    "TagKey":{
327      "type":"string",
328      "max":128,
329      "min":1,
330      "pattern":"^[a-zA-Z0-9/_+=.:@-]+$"
331    },
332    "TagResourceRequest":{
333      "type":"structure",
334      "required":["resourceArn"],
335      "members":{
336        "resourceArn":{
337          "shape":"String",
338          "documentation":"<p>The Amazon Resource Name (ARN) associated with the resource you want to tag.</p>",
339          "location":"uri",
340          "locationName":"resourceArn"
341        },
342        "tags":{
343          "shape":"Tags",
344          "documentation":"<p>A map of key-value pairs, where each pair represents a tag present on the resource.</p>"
345        }
346      }
347    },
348    "TagResourceResponse":{
349      "type":"structure",
350      "members":{
351      }
352    },
353    "TagValue":{
354      "type":"string",
355      "max":256,
356      "min":1,
357      "pattern":"^[a-zA-Z0-9/_+=.:@-]+$"
358    },
359    "Tags":{
360      "type":"map",
361      "key":{"shape":"String"},
362      "value":{"shape":"String"}
363    },
364    "TagsMap":{
365      "type":"map",
366      "key":{"shape":"TagKey"},
367      "value":{"shape":"TagValue"},
368      "max":50,
369      "min":0
370    },
371    "ThrottlingException":{
372      "type":"structure",
373      "required":["message"],
374      "members":{
375        "message":{"shape":"String"}
376      },
377      "documentation":"<p>Too many requests.</p>",
378      "error":{
379        "httpStatusCode":429,
380        "senderFault":true
381      },
382      "exception":true,
383      "retryable":{"throttling":true}
384    },
385    "UntagResourceRequest":{
386      "type":"structure",
387      "required":[
388        "resourceArn",
389        "tagKeys"
390      ],
391      "members":{
392        "resourceArn":{
393          "shape":"String",
394          "documentation":"<p>The Amazon Resource Name (ARN) associated with the resource you want to remove the tag from.</p>",
395          "location":"uri",
396          "locationName":"resourceArn"
397        },
398        "tagKeys":{
399          "shape":"StringList",
400          "documentation":"<p>A list of key names of tags to be removed.</p>",
401          "location":"querystring",
402          "locationName":"tagKeys"
403        }
404      }
405    },
406    "UntagResourceResponse":{
407      "type":"structure",
408      "members":{
409      }
410    },
411    "ValidationException":{
412      "type":"structure",
413      "required":[
414        "fieldName",
415        "message"
416      ],
417      "members":{
418        "fieldName":{
419          "shape":"String",
420          "documentation":"<p>The field name associated with the error.</p>"
421        },
422        "message":{"shape":"String"}
423      },
424      "documentation":"<p>An error occurred during validation.</p>",
425      "error":{
426        "httpStatusCode":400,
427        "senderFault":true
428      },
429      "exception":true
430    }
431  },
432  "documentation":"<p>The AWS Marketplace Deployment Service supports the Quick Launch experience, which is a deployment option for software as a service (SaaS) products. Quick Launch simplifies and reduces the time, resources, and steps required to configure, deploy, and launch a products. The AWS Marketplace Deployment Service provides sellers with a secure method for passing deployment parameters (for example, API keys and external IDs) to buyers during the Quick Launch experience.</p>"
433}
434