@@ -52,26 +52,21 @@ public class CreateJobRequest extends AmazonWebServiceRequest implements Seriali
5252
5353 /**
5454 * <p>
55- * An S3 link to the job document. Required if you don't specify a value for
55+ * An S3 link, or S3 object URL, to the job document. The link is an Amazon
56+ * S3 object URL and is required if you don't specify a value for
5657 * <code>document</code>.
5758 * </p>
58- * <note>
59- * <p>
60- * If the job document resides in an S3 bucket, you must use a placeholder
61- * link when specifying the document.
62- * </p>
6359 * <p>
64- * The placeholder link is of the following form:
60+ * For example,
61+ * <code>--document-source https://s3.<i>region-code</i>.amazonaws.com/example-firmware/device-firmware.1.0</code>
62+ * .
6563 * </p>
6664 * <p>
67- * <code>${aws:iot:s3-presigned-url:https://s3.amazonaws.com/<i>bucket</i>/<i>key</i>}</code>
65+ * For more information, see <a href=
66+ * "https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-bucket-intro.html"
67+ * >Methods for accessing a bucket</a>.
6868 * </p>
6969 * <p>
70- * where <i>bucket</i> is your bucket name and <i>key</i> is the object in
71- * the bucket to which you are linking.
72- * </p>
73- * </note>
74- * <p>
7570 * <b>Constraints:</b><br/>
7671 * <b>Length: </b>1 - 1350<br/>
7772 */
@@ -373,152 +368,122 @@ public CreateJobRequest withTargets(java.util.Collection<String> targets) {
373368
374369 /**
375370 * <p>
376- * An S3 link to the job document. Required if you don't specify a value for
371+ * An S3 link, or S3 object URL, to the job document. The link is an Amazon
372+ * S3 object URL and is required if you don't specify a value for
377373 * <code>document</code>.
378374 * </p>
379- * <note>
380- * <p>
381- * If the job document resides in an S3 bucket, you must use a placeholder
382- * link when specifying the document.
383- * </p>
384375 * <p>
385- * The placeholder link is of the following form:
376+ * For example,
377+ * <code>--document-source https://s3.<i>region-code</i>.amazonaws.com/example-firmware/device-firmware.1.0</code>
378+ * .
386379 * </p>
387380 * <p>
388- * <code>${aws:iot:s3-presigned-url:https://s3.amazonaws.com/<i>bucket</i>/<i>key</i>}</code>
381+ * For more information, see <a href=
382+ * "https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-bucket-intro.html"
383+ * >Methods for accessing a bucket</a>.
389384 * </p>
390385 * <p>
391- * where <i>bucket</i> is your bucket name and <i>key</i> is the object in
392- * the bucket to which you are linking.
393- * </p>
394- * </note>
395- * <p>
396386 * <b>Constraints:</b><br/>
397387 * <b>Length: </b>1 - 1350<br/>
398388 *
399389 * @return <p>
400- * An S3 link to the job document. Required if you don't specify a
401- * value for <code>document</code>.
402- * </p>
403- * <note>
404- * <p>
405- * If the job document resides in an S3 bucket, you must use a
406- * placeholder link when specifying the document.
407- * </p>
408- * <p>
409- * The placeholder link is of the following form:
390+ * An S3 link, or S3 object URL, to the job document. The link is an
391+ * Amazon S3 object URL and is required if you don't specify a value
392+ * for <code>document</code>.
410393 * </p>
411394 * <p>
412- * <code>${aws:iot:s3-presigned-url:https://s3.amazonaws.com/<i>bucket</i>/<i>key</i>}</code>
395+ * For example,
396+ * <code>--document-source https://s3.<i>region-code</i>.amazonaws.com/example-firmware/device-firmware.1.0</code>
397+ * .
413398 * </p>
414399 * <p>
415- * where <i>bucket</i> is your bucket name and <i>key</i> is the
416- * object in the bucket to which you are linking.
400+ * For more information, see <a href=
401+ * "https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-bucket-intro.html"
402+ * >Methods for accessing a bucket</a>.
417403 * </p>
418- * </note>
419404 */
420405 public String getDocumentSource () {
421406 return documentSource ;
422407 }
423408
424409 /**
425410 * <p>
426- * An S3 link to the job document. Required if you don't specify a value for
411+ * An S3 link, or S3 object URL, to the job document. The link is an Amazon
412+ * S3 object URL and is required if you don't specify a value for
427413 * <code>document</code>.
428414 * </p>
429- * <note>
430- * <p>
431- * If the job document resides in an S3 bucket, you must use a placeholder
432- * link when specifying the document.
433- * </p>
434415 * <p>
435- * The placeholder link is of the following form:
416+ * For example,
417+ * <code>--document-source https://s3.<i>region-code</i>.amazonaws.com/example-firmware/device-firmware.1.0</code>
418+ * .
436419 * </p>
437420 * <p>
438- * <code>${aws:iot:s3-presigned-url:https://s3.amazonaws.com/<i>bucket</i>/<i>key</i>}</code>
421+ * For more information, see <a href=
422+ * "https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-bucket-intro.html"
423+ * >Methods for accessing a bucket</a>.
439424 * </p>
440425 * <p>
441- * where <i>bucket</i> is your bucket name and <i>key</i> is the object in
442- * the bucket to which you are linking.
443- * </p>
444- * </note>
445- * <p>
446426 * <b>Constraints:</b><br/>
447427 * <b>Length: </b>1 - 1350<br/>
448428 *
449429 * @param documentSource <p>
450- * An S3 link to the job document. Required if you don't specify
451- * a value for <code>document</code>.
452- * </p>
453- * <note>
454- * <p>
455- * If the job document resides in an S3 bucket, you must use a
456- * placeholder link when specifying the document.
430+ * An S3 link, or S3 object URL, to the job document. The link is
431+ * an Amazon S3 object URL and is required if you don't specify a
432+ * value for <code>document</code>.
457433 * </p>
458434 * <p>
459- * The placeholder link is of the following form:
435+ * For example,
436+ * <code>--document-source https://s3.<i>region-code</i>.amazonaws.com/example-firmware/device-firmware.1.0</code>
437+ * .
460438 * </p>
461439 * <p>
462- * <code>${aws:iot:s3-presigned-url:https://s3.amazonaws.com/<i>bucket</i>/<i>key</i>}</code>
440+ * For more information, see <a href=
441+ * "https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-bucket-intro.html"
442+ * >Methods for accessing a bucket</a>.
463443 * </p>
464- * <p>
465- * where <i>bucket</i> is your bucket name and <i>key</i> is the
466- * object in the bucket to which you are linking.
467- * </p>
468- * </note>
469444 */
470445 public void setDocumentSource (String documentSource ) {
471446 this .documentSource = documentSource ;
472447 }
473448
474449 /**
475450 * <p>
476- * An S3 link to the job document. Required if you don't specify a value for
451+ * An S3 link, or S3 object URL, to the job document. The link is an Amazon
452+ * S3 object URL and is required if you don't specify a value for
477453 * <code>document</code>.
478454 * </p>
479- * <note>
480455 * <p>
481- * If the job document resides in an S3 bucket, you must use a placeholder
482- * link when specifying the document.
456+ * For example,
457+ * <code>--document-source https://s3.<i>region-code</i>.amazonaws.com/example-firmware/device-firmware.1.0</code>
458+ * .
483459 * </p>
484460 * <p>
485- * The placeholder link is of the following form:
461+ * For more information, see <a href=
462+ * "https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-bucket-intro.html"
463+ * >Methods for accessing a bucket</a>.
486464 * </p>
487465 * <p>
488- * <code>${aws:iot:s3-presigned-url:https://s3.amazonaws.com/<i>bucket</i>/<i>key</i>}</code>
489- * </p>
490- * <p>
491- * where <i>bucket</i> is your bucket name and <i>key</i> is the object in
492- * the bucket to which you are linking.
493- * </p>
494- * </note>
495- * <p>
496466 * Returns a reference to this object so that method calls can be chained
497467 * together.
498468 * <p>
499469 * <b>Constraints:</b><br/>
500470 * <b>Length: </b>1 - 1350<br/>
501471 *
502472 * @param documentSource <p>
503- * An S3 link to the job document. Required if you don't specify
504- * a value for <code>document</code>.
505- * </p>
506- * <note>
507- * <p>
508- * If the job document resides in an S3 bucket, you must use a
509- * placeholder link when specifying the document.
473+ * An S3 link, or S3 object URL, to the job document. The link is
474+ * an Amazon S3 object URL and is required if you don't specify a
475+ * value for <code>document</code>.
510476 * </p>
511477 * <p>
512- * The placeholder link is of the following form:
478+ * For example,
479+ * <code>--document-source https://s3.<i>region-code</i>.amazonaws.com/example-firmware/device-firmware.1.0</code>
480+ * .
513481 * </p>
514482 * <p>
515- * <code>${aws:iot:s3-presigned-url:https://s3.amazonaws.com/<i>bucket</i>/<i>key</i>}</code>
483+ * For more information, see <a href=
484+ * "https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-bucket-intro.html"
485+ * >Methods for accessing a bucket</a>.
516486 * </p>
517- * <p>
518- * where <i>bucket</i> is your bucket name and <i>key</i> is the
519- * object in the bucket to which you are linking.
520- * </p>
521- * </note>
522487 * @return A reference to this updated object so that method calls can be
523488 * chained together.
524489 */
0 commit comments