Regenerated library to pick up latest schema changes

Author: petemoore

codegenerator/model/model-data.txt

@@ -284,7 +284,7 @@ Entry 15    =
     Entry Method      = 'get'
     Entry Route       = '/aws/s3/<level>/<bucket>/<prefix>'
     Entry Args        = '[level bucket prefix]'
-    Entry Query        = '[]'
+    Entry Query        = '[format]'
     Entry Name        = 'awsS3Credentials'
     Entry Stability   = 'stable'
     Entry Scopes      = '[[auth:aws-s3:<level>:<bucket>/<prefix>]]'
@@ -348,7 +348,14 @@ Finally, note that the `PutObjectAcl` call is not allowed.  Passing a canned
 ACL other than `private` to `PutObject` is treated as a `PutObjectAcl` call, and
 will result in an access-denied error from AWS.  This limitation is due to a
 security flaw in Amazon S3 which might otherwise allow indefinite access to
-uploaded objects.'
+uploaded objects.
+
+**EC2 metadata compatibility**, if the querystring parameter
+`?format=iam-role-compat` is given, the response will be compatible
+with the JSON exposed by the EC2 metadata service. This aims to ease
+compatibility for libraries and tools built to auto-refresh credentials.
+For details on the format returned by EC2 metadata service see:
+[EC2 User Guide](http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html#instance-metadata-security-credentials).'
 Entry 16    =
     Entry Type        = 'function'
     Entry Method      = 'get'
@@ -6407,7 +6414,14 @@ authorization is not necessary to fetch the artifact.
 **API Clients**, this method will redirect you to the artifact, if it is
 stored externally. Either way, the response may not be JSON. So API
 client users might want to generate a signed URL for this end-point and
-use that URL with a normal HTTP client.'
+use that URL with a normal HTTP client.
+
+**Caching**, artifacts may be cached in data centers closer to the
+workers in-order to reduce bandwidth costs. This can lead to longer
+response times. Caching can be skipped by setting the header
+`x-taskcluster-skip-cache: true`, this should only be used for resources
+where request volume is known to be low, and caching not useful.
+(This feature may be disabled in the future, use is sparingly!)'
 Entry 18    =
     Entry Type        = 'function'
     Entry Method      = 'get'

src/main/java/org/mozilla/taskcluster/client/auth/Auth.java

@@ -349,6 +349,13 @@ public CallSummary<EmptyPayload, SetOfScopes> currentScopes() throws APICallFail
      * will result in an access-denied error from AWS.  This limitation is due to a
      * security flaw in Amazon S3 which might otherwise allow indefinite access to
      * uploaded objects.
+     * 
+     * **EC2 metadata compatibility**, if the querystring parameter
+     * `?format=iam-role-compat` is given, the response will be compatible
+     * with the JSON exposed by the EC2 metadata service. This aims to ease
+     * compatibility for libraries and tools built to auto-refresh credentials.
+     * For details on the format returned by EC2 metadata service see:
+     * [EC2 User Guide](http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html#instance-metadata-security-credentials).
      *
      * Required scopes:
      *

src/main/java/org/mozilla/taskcluster/client/queue/Queue.java

@@ -465,6 +465,13 @@ public CallSummary<Object, Object> createArtifact(String taskId, String runId, S
      * stored externally. Either way, the response may not be JSON. So API
      * client users might want to generate a signed URL for this end-point and
      * use that URL with a normal HTTP client.
+     * 
+     * **Caching**, artifacts may be cached in data centers closer to the
+     * workers in-order to reduce bandwidth costs. This can lead to longer
+     * response times. Caching can be skipped by setting the header
+     * `x-taskcluster-skip-cache: true`, this should only be used for resources
+     * where request volume is known to be low, and caching not useful.
+     * (This feature may be disabled in the future, use is sparingly!)
      *
      * Required scopes:
      *