Skip to content

Commit 5f0db4d

Browse files
author
AWS
committed
Amazon EMR Update: Added APIs for managing Application UIs: Access Persistent (serverless) UIs via CreatePersistentAppUI DescribePersistentAppUI & GetPersistentAppUIPresignedURL, and Cluster-based UIs through GetOnClusterAppUIPresignedURL. Supports Yarn, Spark History, and TEZ interfaces.
1 parent 860dacc commit 5f0db4d

File tree

2 files changed

+277
-0
lines changed

2 files changed

+277
-0
lines changed

‎.changes/next-release/feature-AmazonEMR-da6649e.json

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
{
2+
"type": "feature",
3+
"category": "Amazon EMR",
4+
"contributor": "",
5+
"description": "Added APIs for managing Application UIs: Access Persistent (serverless) UIs via CreatePersistentAppUI DescribePersistentAppUI & GetPersistentAppUIPresignedURL, and Cluster-based UIs through GetOnClusterAppUIPresignedURL. Supports Yarn, Spark History, and TEZ interfaces."
6+
}

‎services/emr/src/main/resources/codegen-resources/service-2.json

Lines changed: 271 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -83,6 +83,20 @@
8383
],
8484
"documentation":"<p>Cancels a pending step or steps in a running cluster. Available only in Amazon EMR versions 4.8.0 and later, excluding version 5.0.0. A maximum of 256 steps are allowed in each CancelSteps request. CancelSteps is idempotent but asynchronous; it does not guarantee that a step will be canceled, even if the request is successfully submitted. When you use Amazon EMR releases 5.28.0 and later, you can cancel steps that are in a <code>PENDING</code> or <code>RUNNING</code> state. In earlier versions of Amazon EMR, you can only cancel steps that are in a <code>PENDING</code> state. </p>"
8585
},
86+
"CreatePersistentAppUI":{
87+
"name":"CreatePersistentAppUI",
88+
"http":{
89+
"method":"POST",
90+
"requestUri":"/"
91+
},
92+
"input":{"shape":"CreatePersistentAppUIInput"},
93+
"output":{"shape":"CreatePersistentAppUIOutput"},
94+
"errors":[
95+
{"shape":"InternalServerException"},
96+
{"shape":"InvalidRequestException"}
97+
],
98+
"documentation":"<p>Creates a persistent application user interface.</p>"
99+
},
86100
"CreateSecurityConfiguration":{
87101
"name":"CreateSecurityConfiguration",
88102
"http":{
@@ -206,6 +220,20 @@
206220
],
207221
"documentation":"<p>Provides details of a notebook execution.</p>"
208222
},
223+
"DescribePersistentAppUI":{
224+
"name":"DescribePersistentAppUI",
225+
"http":{
226+
"method":"POST",
227+
"requestUri":"/"
228+
},
229+
"input":{"shape":"DescribePersistentAppUIInput"},
230+
"output":{"shape":"DescribePersistentAppUIOutput"},
231+
"errors":[
232+
{"shape":"InternalServerException"},
233+
{"shape":"InvalidRequestException"}
234+
],
235+
"documentation":"<p>Describes a persistent application user interface.</p>"
236+
},
209237
"DescribeReleaseLabel":{
210238
"name":"DescribeReleaseLabel",
211239
"http":{
@@ -310,6 +338,34 @@
310338
"output":{"shape":"GetManagedScalingPolicyOutput"},
311339
"documentation":"<p>Fetches the attached managed scaling policy for an Amazon EMR cluster. </p>"
312340
},
341+
"GetOnClusterAppUIPresignedURL":{
342+
"name":"GetOnClusterAppUIPresignedURL",
343+
"http":{
344+
"method":"POST",
345+
"requestUri":"/"
346+
},
347+
"input":{"shape":"GetOnClusterAppUIPresignedURLInput"},
348+
"output":{"shape":"GetOnClusterAppUIPresignedURLOutput"},
349+
"errors":[
350+
{"shape":"InternalServerError"},
351+
{"shape":"InvalidRequestException"}
352+
],
353+
"documentation":"<p>The presigned URL properties for the cluster's application user interface.</p>"
354+
},
355+
"GetPersistentAppUIPresignedURL":{
356+
"name":"GetPersistentAppUIPresignedURL",
357+
"http":{
358+
"method":"POST",
359+
"requestUri":"/"
360+
},
361+
"input":{"shape":"GetPersistentAppUIPresignedURLInput"},
362+
"output":{"shape":"GetPersistentAppUIPresignedURLOutput"},
363+
"errors":[
364+
{"shape":"InternalServerError"},
365+
{"shape":"InvalidRequestException"}
366+
],
367+
"documentation":"<p>The presigned URL properties for the cluster's application user interface.</p>"
368+
},
313369
"GetStudioSessionMapping":{
314370
"name":"GetStudioSessionMapping",
315371
"http":{
@@ -1553,6 +1609,45 @@
15531609
"type":"list",
15541610
"member":{"shape":"Configuration"}
15551611
},
1612+
"CreatePersistentAppUIInput":{
1613+
"type":"structure",
1614+
"required":["TargetResourceArn"],
1615+
"members":{
1616+
"TargetResourceArn":{
1617+
"shape":"ArnType",
1618+
"documentation":"<p>The unique Amazon Resource Name (ARN) of the target resource.</p>"
1619+
},
1620+
"EMRContainersConfig":{
1621+
"shape":"EMRContainersConfig",
1622+
"documentation":"<p>The EMR containers configuration.</p>"
1623+
},
1624+
"Tags":{
1625+
"shape":"TagList",
1626+
"documentation":"<p>Tags for the persistent application user interface.</p>"
1627+
},
1628+
"XReferer":{
1629+
"shape":"String",
1630+
"documentation":"<p>The cross reference for the persistent application user interface.</p>"
1631+
},
1632+
"ProfilerType":{
1633+
"shape":"ProfilerType",
1634+
"documentation":"<p>The profiler type for the persistent application user interface. Valid values are SHS, TEZUI, or YTS.</p>"
1635+
}
1636+
}
1637+
},
1638+
"CreatePersistentAppUIOutput":{
1639+
"type":"structure",
1640+
"members":{
1641+
"PersistentAppUIId":{
1642+
"shape":"XmlStringMaxLen256",
1643+
"documentation":"<p>The persistent application user interface identifier.</p>"
1644+
},
1645+
"RuntimeRoleEnabledCluster":{
1646+
"shape":"Boolean",
1647+
"documentation":"<p>Represents if the EMR on EC2 cluster that the persisent application user interface is created for is a runtime role enabled cluster or not.</p>"
1648+
}
1649+
}
1650+
},
15561651
"CreateSecurityConfigurationInput":{
15571652
"type":"structure",
15581653
"required":[
@@ -1847,6 +1942,25 @@
18471942
}
18481943
}
18491944
},
1945+
"DescribePersistentAppUIInput":{
1946+
"type":"structure",
1947+
"required":["PersistentAppUIId"],
1948+
"members":{
1949+
"PersistentAppUIId":{
1950+
"shape":"XmlStringMaxLen256",
1951+
"documentation":"<p>The identifier for the persistent application user interface.</p>"
1952+
}
1953+
}
1954+
},
1955+
"DescribePersistentAppUIOutput":{
1956+
"type":"structure",
1957+
"members":{
1958+
"PersistentAppUI":{
1959+
"shape":"PersistentAppUI",
1960+
"documentation":"<p>The persistent application user interface.</p>"
1961+
}
1962+
}
1963+
},
18501964
"DescribeReleaseLabelInput":{
18511965
"type":"structure",
18521966
"members":{
@@ -1967,6 +2081,16 @@
19672081
"type":"list",
19682082
"member":{"shape":"InstanceId"}
19692083
},
2084+
"EMRContainersConfig":{
2085+
"type":"structure",
2086+
"members":{
2087+
"JobRunId":{
2088+
"shape":"XmlStringMaxLen256",
2089+
"documentation":"<p>The Job run ID for the container configuration.</p>"
2090+
}
2091+
},
2092+
"documentation":"<p>The EMR container configuration.</p>"
2093+
},
19702094
"EbsBlockDevice":{
19712095
"type":"structure",
19722096
"members":{
@@ -2256,6 +2380,84 @@
22562380
}
22572381
}
22582382
},
2383+
"GetOnClusterAppUIPresignedURLInput":{
2384+
"type":"structure",
2385+
"required":["ClusterId"],
2386+
"members":{
2387+
"ClusterId":{
2388+
"shape":"XmlStringMaxLen256",
2389+
"documentation":"<p>The cluster ID associated with the cluster's application user interface presigned URL.</p>"
2390+
},
2391+
"OnClusterAppUIType":{
2392+
"shape":"OnClusterAppUIType",
2393+
"documentation":"<p>The application UI type associated with the cluster's application user interface presigned URL.</p>"
2394+
},
2395+
"ApplicationId":{
2396+
"shape":"XmlStringMaxLen256",
2397+
"documentation":"<p>The application ID associated with the cluster's application user interface presigned URL.</p>"
2398+
},
2399+
"DryRun":{
2400+
"shape":"BooleanObject",
2401+
"documentation":"<p>Determines if the user interface presigned URL is for a dry run.</p>"
2402+
},
2403+
"ExecutionRoleArn":{
2404+
"shape":"ArnType",
2405+
"documentation":"<p>The execution role ARN associated with the cluster's application user interface presigned URL.</p>"
2406+
}
2407+
}
2408+
},
2409+
"GetOnClusterAppUIPresignedURLOutput":{
2410+
"type":"structure",
2411+
"members":{
2412+
"PresignedURLReady":{
2413+
"shape":"Boolean",
2414+
"documentation":"<p>Used to determine if the presigned URL is ready.</p>"
2415+
},
2416+
"PresignedURL":{
2417+
"shape":"XmlString",
2418+
"documentation":"<p>The cluster's generated presigned URL.</p>"
2419+
}
2420+
}
2421+
},
2422+
"GetPersistentAppUIPresignedURLInput":{
2423+
"type":"structure",
2424+
"required":["PersistentAppUIId"],
2425+
"members":{
2426+
"PersistentAppUIId":{
2427+
"shape":"XmlStringMaxLen256",
2428+
"documentation":"<p>The persistent application user interface ID associated with the presigned URL.</p>"
2429+
},
2430+
"PersistentAppUIType":{
2431+
"shape":"PersistentAppUIType",
2432+
"documentation":"<p>The persistent application user interface type associated with the presigned URL.</p>"
2433+
},
2434+
"ApplicationId":{
2435+
"shape":"XmlStringMaxLen256",
2436+
"documentation":"<p>The application ID associated with the presigned URL.</p>"
2437+
},
2438+
"AuthProxyCall":{
2439+
"shape":"BooleanObject",
2440+
"documentation":"<p>A boolean that represents if the caller is an authentication proxy call.</p>"
2441+
},
2442+
"ExecutionRoleArn":{
2443+
"shape":"ArnType",
2444+
"documentation":"<p>The execution role ARN associated with the presigned URL.</p>"
2445+
}
2446+
}
2447+
},
2448+
"GetPersistentAppUIPresignedURLOutput":{
2449+
"type":"structure",
2450+
"members":{
2451+
"PresignedURLReady":{
2452+
"shape":"Boolean",
2453+
"documentation":"<p>Used to determine if the presigned URL is ready.</p>"
2454+
},
2455+
"PresignedURL":{
2456+
"shape":"XmlString",
2457+
"documentation":"<p>The returned presigned URL.</p>"
2458+
}
2459+
}
2460+
},
22592461
"GetStudioSessionMappingInput":{
22602462
"type":"structure",
22612463
"required":[
@@ -4220,6 +4422,17 @@
42204422
"type":"list",
42214423
"member":{"shape":"OSRelease"}
42224424
},
4425+
"OnClusterAppUIType":{
4426+
"type":"string",
4427+
"enum":[
4428+
"SparkHistoryServer",
4429+
"YarnTimelineService",
4430+
"TezUI",
4431+
"ApplicationMaster",
4432+
"JobHistoryServer",
4433+
"ResourceManager"
4434+
]
4435+
},
42234436
"OnDemandCapacityReservationOptions":{
42244437
"type":"structure",
42254438
"members":{
@@ -4323,6 +4536,56 @@
43234536
},
43244537
"documentation":"<p>The Amazon S3 location that stores the notebook execution output.</p>"
43254538
},
4539+
"PersistentAppUI":{
4540+
"type":"structure",
4541+
"members":{
4542+
"PersistentAppUIId":{
4543+
"shape":"XmlStringMaxLen256",
4544+
"documentation":"<p>The identifier for the persistent application user interface object.</p>"
4545+
},
4546+
"PersistentAppUITypeList":{
4547+
"shape":"PersistentAppUITypeList",
4548+
"documentation":"<p>The type list for the persistent application user interface object. Valid values include SHS, YTS, or TEZ.</p>"
4549+
},
4550+
"PersistentAppUIStatus":{
4551+
"shape":"XmlStringMaxLen256",
4552+
"documentation":"<p>The status for the persistent application user interface object.</p>"
4553+
},
4554+
"AuthorId":{
4555+
"shape":"XmlStringMaxLen256",
4556+
"documentation":"<p>The author ID for the persistent application user interface object.</p>"
4557+
},
4558+
"CreationTime":{
4559+
"shape":"Date",
4560+
"documentation":"<p>The creation date and time for the persistent application user interface object.</p>"
4561+
},
4562+
"LastModifiedTime":{
4563+
"shape":"Date",
4564+
"documentation":"<p>The date and time the persistent application user interface object was last changed.</p>"
4565+
},
4566+
"LastStateChangeReason":{
4567+
"shape":"XmlString",
4568+
"documentation":"<p>The reason the persistent application user interface object was last changed.</p>"
4569+
},
4570+
"Tags":{
4571+
"shape":"TagList",
4572+
"documentation":"<p>A collection of tags for the persistent application user interface object.</p>"
4573+
}
4574+
},
4575+
"documentation":"<p>Holds persistent application user interface information. Applications installed on the Amazon EMR cluster publish user interfaces as web sites to monitor cluster activity.</p>"
4576+
},
4577+
"PersistentAppUIType":{
4578+
"type":"string",
4579+
"enum":[
4580+
"SHS",
4581+
"TEZ",
4582+
"YTS"
4583+
]
4584+
},
4585+
"PersistentAppUITypeList":{
4586+
"type":"list",
4587+
"member":{"shape":"PersistentAppUIType"}
4588+
},
43264589
"PlacementGroupConfig":{
43274590
"type":"structure",
43284591
"required":["InstanceRole"],
@@ -4389,6 +4652,14 @@
43894652
"type":"list",
43904653
"member":{"shape":"PortRange"}
43914654
},
4655+
"ProfilerType":{
4656+
"type":"string",
4657+
"enum":[
4658+
"SHS",
4659+
"TEZUI",
4660+
"YTS"
4661+
]
4662+
},
43924663
"PutAutoScalingPolicyInput":{
43934664
"type":"structure",
43944665
"required":[

0 commit comments

Comments
 (0)