Skip to content

Commit 54b5d57

Browse files
author
AWS
committed
Amazon SageMaker Service Update: This release adds the ability for customers to attach and detach their EBS volumes to EKS-orchestrated HyperPod cluster nodes.
1 parent a09c3c7 commit 54b5d57

File tree

3 files changed

+174
-2
lines changed

3 files changed

+174
-2
lines changed

‎.attach_pid802

Whitespace-only changes.

‎.changes/next-release/feature-AmazonSageMakerService-78814b2.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 SageMaker Service",
4+
"contributor": "",
5+
"description": "This release adds the ability for customers to attach and detach their EBS volumes to EKS-orchestrated HyperPod cluster nodes."
6+
}

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

Lines changed: 168 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -54,6 +54,19 @@
5454
],
5555
"documentation":"<p>Associates a trial component with a trial. A trial component can be associated with multiple trials. To disassociate a trial component from a trial, call the <a href=\"https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DisassociateTrialComponent.html\">DisassociateTrialComponent</a> API.</p>"
5656
},
57+
"AttachClusterNodeVolume":{
58+
"name":"AttachClusterNodeVolume",
59+
"http":{
60+
"method":"POST",
61+
"requestUri":"/"
62+
},
63+
"input":{"shape":"AttachClusterNodeVolumeRequest"},
64+
"output":{"shape":"AttachClusterNodeVolumeResponse"},
65+
"errors":[
66+
{"shape":"ResourceNotFound"}
67+
],
68+
"documentation":"<p> Attaches your Amazon Elastic Block Store (Amazon EBS) volume to a node in your EKS-orchestrated HyperPod cluster. </p> <p> This API works with the Amazon Elastic Block Store (Amazon EBS) Container Storage Interface (CSI) driver to manage the lifecycle of persistent storage in your HyperPod EKS clusters. </p>"
69+
},
5770
"BatchDeleteClusterNodes":{
5871
"name":"BatchDeleteClusterNodes",
5972
"http":{
@@ -2464,6 +2477,19 @@
24642477
"output":{"shape":"DescribeWorkteamResponse"},
24652478
"documentation":"<p>Gets information about a specific work team. You can see information such as the creation date, the last updated date, membership information, and the work team's Amazon Resource Name (ARN).</p>"
24662479
},
2480+
"DetachClusterNodeVolume":{
2481+
"name":"DetachClusterNodeVolume",
2482+
"http":{
2483+
"method":"POST",
2484+
"requestUri":"/"
2485+
},
2486+
"input":{"shape":"DetachClusterNodeVolumeRequest"},
2487+
"output":{"shape":"DetachClusterNodeVolumeResponse"},
2488+
"errors":[
2489+
{"shape":"ResourceNotFound"}
2490+
],
2491+
"documentation":"<p> Detaches your Amazon Elastic Block Store (Amazon EBS) volume from a node in your EKS-orchestrated SageMaker HyperPod cluster.</p> <p> This API works with the Amazon Elastic Block Store (Amazon EBS) Container Storage Interface (CSI) driver to manage the lifecycle of persistent storage in your HyperPod EKS clusters. </p>"
2492+
},
24672493
"DisableSagemakerServicecatalogPortfolio":{
24682494
"name":"DisableSagemakerServicecatalogPortfolio",
24692495
"http":{
@@ -4452,7 +4478,7 @@
44524478
"errors":[
44534479
{"shape":"ConflictException"}
44544480
],
4455-
"documentation":"<p>Use this operation to update your workforce. You can use this operation to require that workers use specific IP addresses to work on tasks and to update your OpenID Connect (OIDC) Identity Provider (IdP) workforce configuration.</p> <p>The worker portal is now supported in VPC and public internet.</p> <p> Use <code>SourceIpConfig</code> to restrict worker access to tasks to a specific range of IP addresses. You specify allowed IP addresses by creating a list of up to ten <a href=\"https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html\">CIDRs</a>. By default, a workforce isn't restricted to specific IP addresses. If you specify a range of IP addresses, workers who attempt to access tasks using any IP address outside the specified range are denied and get a <code>Not Found</code> error message on the worker portal.</p> <p>To restrict access to all the workers in public internet, add the <code>SourceIpConfig</code> CIDR value as \"10.0.0.0/16\".</p> <important> <p>Amazon SageMaker does not support Source Ip restriction for worker portals in VPC.</p> </important> <p>Use <code>OidcConfig</code> to update the configuration of a workforce created using your own OIDC IdP. </p> <important> <p>You can only update your OIDC IdP configuration when there are no work teams associated with your workforce. You can delete work teams using the <a href=\"https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DeleteWorkteam.html\">DeleteWorkteam</a> operation.</p> </important> <p>After restricting access to a range of IP addresses or updating your OIDC IdP configuration with this operation, you can view details about your update workforce using the <a href=\"https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeWorkforce.html\">DescribeWorkforce</a> operation.</p> <important> <p>This operation only applies to private workforces.</p> </important>"
4481+
"documentation":"<p>Use this operation to update your workforce. You can use this operation to require that workers use specific IP addresses to work on tasks and to update your OpenID Connect (OIDC) Identity Provider (IdP) workforce configuration.</p> <p>The worker portal is now supported in VPC and public internet.</p> <p> Use <code>SourceIpConfig</code> to restrict worker access to tasks to a specific range of IP addresses. You specify allowed IP addresses by creating a list of up to ten <a href=\"https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html\">CIDRs</a>. By default, a workforce isn't restricted to specific IP addresses. If you specify a range of IP addresses, workers who attempt to access tasks using any IP address outside the specified range are denied and get a <code>Not Found</code> error message on the worker portal.</p> <p>To restrict public internet access for all workers, configure the <code>SourceIpConfig</code> CIDR value. For example, when using <code>SourceIpConfig</code> with an <code>IpAddressType</code> of <code>IPv4</code>, you can restrict access to the IPv4 CIDR block \"10.0.0.0/16\". When using an <code>IpAddressType</code> of <code>dualstack</code>, you can specify both the IPv4 and IPv6 CIDR blocks, such as \"10.0.0.0/16\" for IPv4 only, \"2001:db8:1234:1a00::/56\" for IPv6 only, or \"10.0.0.0/16\" and \"2001:db8:1234:1a00::/56\" for dual stack.</p> <important> <p>Amazon SageMaker does not support Source Ip restriction for worker portals in VPC.</p> </important> <p>Use <code>OidcConfig</code> to update the configuration of a workforce created using your own OIDC IdP. </p> <important> <p>You can only update your OIDC IdP configuration when there are no work teams associated with your workforce. You can delete work teams using the <a href=\"https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DeleteWorkteam.html\">DeleteWorkteam</a> operation.</p> </important> <p>After restricting access to a range of IP addresses or updating your OIDC IdP configuration with this operation, you can view details about your update workforce using the <a href=\"https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeWorkforce.html\">DescribeWorkforce</a> operation.</p> <important> <p>This operation only applies to private workforces.</p> </important>"
44564482
},
44574483
"UpdateWorkteam":{
44584484
"name":"UpdateWorkteam",
@@ -5737,6 +5763,65 @@
57375763
"min":1,
57385764
"pattern":"[a-zA-Z0-9._-]+"
57395765
},
5766+
"AttachClusterNodeVolumeRequest":{
5767+
"type":"structure",
5768+
"required":[
5769+
"ClusterArn",
5770+
"NodeId",
5771+
"VolumeId"
5772+
],
5773+
"members":{
5774+
"ClusterArn":{
5775+
"shape":"ClusterArn",
5776+
"documentation":"<p> The Amazon Resource Name (ARN) of your SageMaker HyperPod cluster containing the target node. Your cluster must use EKS as the orchestration and be in the <code>InService</code> state. </p>"
5777+
},
5778+
"NodeId":{
5779+
"shape":"ClusterNodeId",
5780+
"documentation":"<p> The unique identifier of the cluster node to which you want to attach the volume. The node must belong to your specified HyperPod cluster and cannot be part of a Restricted Instance Group (RIG). </p>"
5781+
},
5782+
"VolumeId":{
5783+
"shape":"VolumeId",
5784+
"documentation":"<p> The unique identifier of your EBS volume to attach. The volume must be in the <code>available</code> state. </p>"
5785+
}
5786+
}
5787+
},
5788+
"AttachClusterNodeVolumeResponse":{
5789+
"type":"structure",
5790+
"required":[
5791+
"ClusterArn",
5792+
"NodeId",
5793+
"VolumeId",
5794+
"AttachTime",
5795+
"Status",
5796+
"DeviceName"
5797+
],
5798+
"members":{
5799+
"ClusterArn":{
5800+
"shape":"ClusterArn",
5801+
"documentation":"<p> The Amazon Resource Name (ARN) of your SageMaker HyperPod cluster where the volume attachment operation was performed. </p>"
5802+
},
5803+
"NodeId":{
5804+
"shape":"ClusterNodeId",
5805+
"documentation":"<p> The unique identifier of the cluster node where your volume was attached. </p>"
5806+
},
5807+
"VolumeId":{
5808+
"shape":"VolumeId",
5809+
"documentation":"<p> The unique identifier of your EBS volume that was attached. </p>"
5810+
},
5811+
"AttachTime":{
5812+
"shape":"Timestamp",
5813+
"documentation":"<p> The timestamp when the volume attachment operation was initiated by the SageMaker HyperPod service. </p>"
5814+
},
5815+
"Status":{
5816+
"shape":"VolumeAttachmentStatus",
5817+
"documentation":"<p> The current status of your volume attachment operation. </p>"
5818+
},
5819+
"DeviceName":{
5820+
"shape":"VolumeDeviceName",
5821+
"documentation":"<p> The device name assigned to your attached volume on the target instance. </p>"
5822+
}
5823+
}
5824+
},
57405825
"AttributeName":{
57415826
"type":"string",
57425827
"max":256,
@@ -19116,6 +19201,65 @@
1911619201
"min":0,
1911719202
"pattern":"(https|s3)://([^/])/?(.*)"
1911819203
},
19204+
"DetachClusterNodeVolumeRequest":{
19205+
"type":"structure",
19206+
"required":[
19207+
"ClusterArn",
19208+
"NodeId",
19209+
"VolumeId"
19210+
],
19211+
"members":{
19212+
"ClusterArn":{
19213+
"shape":"ClusterArn",
19214+
"documentation":"<p> The Amazon Resource Name (ARN) of your SageMaker HyperPod cluster containing the target node. Your cluster must use EKS as the orchestration and be in the <code>InService</code> state. </p>"
19215+
},
19216+
"NodeId":{
19217+
"shape":"ClusterNodeId",
19218+
"documentation":"<p> The unique identifier of the cluster node from which you want to detach the volume. </p>"
19219+
},
19220+
"VolumeId":{
19221+
"shape":"VolumeId",
19222+
"documentation":"<p> The unique identifier of your EBS volume that you want to detach. Your volume must be currently attached to the specified node. </p>"
19223+
}
19224+
}
19225+
},
19226+
"DetachClusterNodeVolumeResponse":{
19227+
"type":"structure",
19228+
"required":[
19229+
"ClusterArn",
19230+
"NodeId",
19231+
"VolumeId",
19232+
"AttachTime",
19233+
"Status",
19234+
"DeviceName"
19235+
],
19236+
"members":{
19237+
"ClusterArn":{
19238+
"shape":"ClusterArn",
19239+
"documentation":"<p> The Amazon Resource Name (ARN) of your SageMaker HyperPod cluster where the volume detachment operation was performed. </p>"
19240+
},
19241+
"NodeId":{
19242+
"shape":"ClusterNodeId",
19243+
"documentation":"<p> The unique identifier of the cluster node from which your volume was detached. </p>"
19244+
},
19245+
"VolumeId":{
19246+
"shape":"VolumeId",
19247+
"documentation":"<p> The unique identifier of your EBS volume that was detached. </p>"
19248+
},
19249+
"AttachTime":{
19250+
"shape":"Timestamp",
19251+
"documentation":"<p> The original timestamp when your volume was initially attached to the node. </p>"
19252+
},
19253+
"Status":{
19254+
"shape":"VolumeAttachmentStatus",
19255+
"documentation":"<p> The current status of your volume detachment operation. </p>"
19256+
},
19257+
"DeviceName":{
19258+
"shape":"VolumeDeviceName",
19259+
"documentation":"<p> The device name assigned to your attached volume on the target instance. </p>"
19260+
}
19261+
}
19262+
},
1911919263
"DetailedAlgorithmStatus":{
1912019264
"type":"string",
1912119265
"enum":[
@@ -42165,7 +42309,7 @@
4216542309
},
4216642310
"SingleSignOnApplicationArn":{
4216742311
"shape":"SingleSignOnApplicationArn",
42168-
"documentation":"<p>The ARN of the application managed by SageMaker AI and SageMaker Unified Studio in the Amazon Web Services IAM Identity Center.</p>"
42312+
"documentation":"<p>The ARN of the Amazon DataZone application managed by Amazon SageMaker Unified Studio in the Amazon Web Services IAM Identity Center.</p>"
4216942313
}
4217042314
},
4217142315
"documentation":"<p>The settings that apply to an Amazon SageMaker AI domain when you use it in Amazon SageMaker Unified Studio.</p>"
@@ -44170,6 +44314,28 @@
4417044314
"min":0,
4417144315
"pattern":"([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)"
4417244316
},
44317+
"VolumeAttachmentStatus":{
44318+
"type":"string",
44319+
"enum":[
44320+
"attaching",
44321+
"attached",
44322+
"detaching",
44323+
"detached",
44324+
"busy"
44325+
]
44326+
},
44327+
"VolumeDeviceName":{
44328+
"type":"string",
44329+
"max":32,
44330+
"min":1,
44331+
"pattern":"/dev/(xvd[a-z]|sd[b-z]|sd[f-p][1-6])"
44332+
},
44333+
"VolumeId":{
44334+
"type":"string",
44335+
"max":256,
44336+
"min":1,
44337+
"pattern":"vol-[a-f0-9]{8}(?:[a-f0-9]{9})?"
44338+
},
4417344339
"VolumeSizeInGB":{
4417444340
"type":"integer",
4417544341
"min":1

0 commit comments

Comments
 (0)