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