Skip to content

Commit 60d759d

Browse files
author
awstools
committed
feat(client-sagemaker): Extend DescribeClusterNode response with private DNS hostname and IP address, and placement information about availability zone and availability zone ID.
1 parent 370c001 commit 60d759d

File tree

10 files changed

+347
-225
lines changed

10 files changed

+347
-225
lines changed

clients/client-sagemaker/src/commands/CreateSpaceCommand.ts

+2-1
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,8 @@ import { Command as $Command } from "@smithy/smithy-client";
55
import { MetadataBearer as __MetadataBearer } from "@smithy/types";
66

77
import { commonParams } from "../endpoint/EndpointParameters";
8-
import { CreateSpaceRequest, CreateSpaceResponse } from "../models/models_1";
8+
import { CreateSpaceRequest } from "../models/models_1";
9+
import { CreateSpaceResponse } from "../models/models_2";
910
import { de_CreateSpaceCommand, se_CreateSpaceCommand } from "../protocols/Aws_json1_1";
1011
import { SageMakerClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../SageMakerClient";
1112

clients/client-sagemaker/src/commands/DescribeClusterNodeCommand.ts

+7-1
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ export interface DescribeClusterNodeCommandInput extends DescribeClusterNodeRequ
2727
export interface DescribeClusterNodeCommandOutput extends DescribeClusterNodeResponse, __MetadataBearer {}
2828

2929
/**
30-
* <p>Retrieves information of an instance (also called a <i>node</i>
30+
* <p>Retrieves information of a node (also called a <i>instance</i>
3131
* interchangeably) of a SageMaker HyperPod cluster.</p>
3232
* @example
3333
* Use a bare-bones client and the command you need to make an API call.
@@ -56,6 +56,12 @@ export interface DescribeClusterNodeCommandOutput extends DescribeClusterNodeRes
5656
* // OnCreate: "STRING_VALUE", // required
5757
* // },
5858
* // ThreadsPerCore: Number("int"),
59+
* // PrivatePrimaryIp: "STRING_VALUE",
60+
* // PrivateDnsHostname: "STRING_VALUE",
61+
* // Placement: { // ClusterInstancePlacement
62+
* // AvailabilityZone: "STRING_VALUE",
63+
* // AvailabilityZoneId: "STRING_VALUE",
64+
* // },
5965
* // },
6066
* // };
6167
*

clients/client-sagemaker/src/commands/ListNotebookInstancesCommand.ts

+1-2
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,7 @@ import { Command as $Command } from "@smithy/smithy-client";
55
import { MetadataBearer as __MetadataBearer } from "@smithy/types";
66

77
import { commonParams } from "../endpoint/EndpointParameters";
8-
import { ListNotebookInstancesInput } from "../models/models_3";
9-
import { ListNotebookInstancesOutput } from "../models/models_4";
8+
import { ListNotebookInstancesInput, ListNotebookInstancesOutput } from "../models/models_4";
109
import { de_ListNotebookInstancesCommand, se_ListNotebookInstancesCommand } from "../protocols/Aws_json1_1";
1110
import { SageMakerClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../SageMakerClient";
1211

clients/client-sagemaker/src/models/models_0.ts

+38-78
Original file line numberDiff line numberDiff line change
@@ -9094,6 +9094,26 @@ export interface ClusterInstanceGroupSpecification {
90949094
ThreadsPerCore?: number;
90959095
}
90969096

9097+
/**
9098+
* <p>Specifies the placement details for the node in the SageMaker HyperPod cluster, including the
9099+
* Availability Zone and the unique identifier (ID) of the Availability Zone.</p>
9100+
* @public
9101+
*/
9102+
export interface ClusterInstancePlacement {
9103+
/**
9104+
* <p>The Availability Zone where the node in the SageMaker HyperPod cluster is launched.</p>
9105+
* @public
9106+
*/
9107+
AvailabilityZone?: string;
9108+
9109+
/**
9110+
* <p>The unique identifier (ID) of the Availability Zone where the node in the SageMaker HyperPod cluster
9111+
* is launched.</p>
9112+
* @public
9113+
*/
9114+
AvailabilityZoneId?: string;
9115+
}
9116+
90979117
/**
90989118
* @public
90999119
* @enum
@@ -9177,6 +9197,24 @@ export interface ClusterNodeDetails {
91779197
* @public
91789198
*/
91799199
ThreadsPerCore?: number;
9200+
9201+
/**
9202+
* <p>The private primary IP address of the SageMaker HyperPod cluster node.</p>
9203+
* @public
9204+
*/
9205+
PrivatePrimaryIp?: string;
9206+
9207+
/**
9208+
* <p>The private DNS hostname of the SageMaker HyperPod cluster node.</p>
9209+
* @public
9210+
*/
9211+
PrivateDnsHostname?: string;
9212+
9213+
/**
9214+
* <p>The placement details of the SageMaker HyperPod cluster node.</p>
9215+
* @public
9216+
*/
9217+
Placement?: ClusterInstancePlacement;
91809218
}
91819219

91829220
/**
@@ -11614,81 +11652,3 @@ export interface InputConfig {
1161411652
*/
1161511653
FrameworkVersion?: string;
1161611654
}
11617-
11618-
/**
11619-
* <p>Contains information about a target platform that you want your model to run on, such
11620-
* as OS, architecture, and accelerators. It is an alternative of
11621-
* <code>TargetDevice</code>.</p>
11622-
* @public
11623-
*/
11624-
export interface TargetPlatform {
11625-
/**
11626-
* <p>Specifies a target platform OS.</p>
11627-
* <ul>
11628-
* <li>
11629-
* <p>
11630-
* <code>LINUX</code>: Linux-based operating systems.</p>
11631-
* </li>
11632-
* <li>
11633-
* <p>
11634-
* <code>ANDROID</code>: Android operating systems. Android API level can be
11635-
* specified using the <code>ANDROID_PLATFORM</code> compiler option. For example,
11636-
* <code>"CompilerOptions": \{'ANDROID_PLATFORM': 28\}</code>
11637-
* </p>
11638-
* </li>
11639-
* </ul>
11640-
* @public
11641-
*/
11642-
Os: TargetPlatformOs | undefined;
11643-
11644-
/**
11645-
* <p>Specifies a target platform architecture.</p>
11646-
* <ul>
11647-
* <li>
11648-
* <p>
11649-
* <code>X86_64</code>: 64-bit version of the x86 instruction set.</p>
11650-
* </li>
11651-
* <li>
11652-
* <p>
11653-
* <code>X86</code>: 32-bit version of the x86 instruction set.</p>
11654-
* </li>
11655-
* <li>
11656-
* <p>
11657-
* <code>ARM64</code>: ARMv8 64-bit CPU.</p>
11658-
* </li>
11659-
* <li>
11660-
* <p>
11661-
* <code>ARM_EABIHF</code>: ARMv7 32-bit, Hard Float.</p>
11662-
* </li>
11663-
* <li>
11664-
* <p>
11665-
* <code>ARM_EABI</code>: ARMv7 32-bit, Soft Float. Used by Android 32-bit ARM
11666-
* platform.</p>
11667-
* </li>
11668-
* </ul>
11669-
* @public
11670-
*/
11671-
Arch: TargetPlatformArch | undefined;
11672-
11673-
/**
11674-
* <p>Specifies a target platform accelerator (optional).</p>
11675-
* <ul>
11676-
* <li>
11677-
* <p>
11678-
* <code>NVIDIA</code>: Nvidia graphics processing unit. It also requires
11679-
* <code>gpu-code</code>, <code>trt-ver</code>, <code>cuda-ver</code> compiler
11680-
* options</p>
11681-
* </li>
11682-
* <li>
11683-
* <p>
11684-
* <code>MALI</code>: ARM Mali graphics processor</p>
11685-
* </li>
11686-
* <li>
11687-
* <p>
11688-
* <code>INTEL_GRAPHICS</code>: Integrated Intel graphics</p>
11689-
* </li>
11690-
* </ul>
11691-
* @public
11692-
*/
11693-
Accelerator?: TargetPlatformAccelerator;
11694-
}

clients/client-sagemaker/src/models/models_1.ts

+81-12
Original file line numberDiff line numberDiff line change
@@ -57,13 +57,93 @@ import {
5757
StoppingCondition,
5858
Tag,
5959
TargetDevice,
60-
TargetPlatform,
60+
TargetPlatformAccelerator,
61+
TargetPlatformArch,
62+
TargetPlatformOs,
6163
TrainingInputMode,
6264
TrainingInstanceType,
6365
TransformJobDefinition,
6466
VpcConfig,
6567
} from "./models_0";
6668

69+
/**
70+
* <p>Contains information about a target platform that you want your model to run on, such
71+
* as OS, architecture, and accelerators. It is an alternative of
72+
* <code>TargetDevice</code>.</p>
73+
* @public
74+
*/
75+
export interface TargetPlatform {
76+
/**
77+
* <p>Specifies a target platform OS.</p>
78+
* <ul>
79+
* <li>
80+
* <p>
81+
* <code>LINUX</code>: Linux-based operating systems.</p>
82+
* </li>
83+
* <li>
84+
* <p>
85+
* <code>ANDROID</code>: Android operating systems. Android API level can be
86+
* specified using the <code>ANDROID_PLATFORM</code> compiler option. For example,
87+
* <code>"CompilerOptions": \{'ANDROID_PLATFORM': 28\}</code>
88+
* </p>
89+
* </li>
90+
* </ul>
91+
* @public
92+
*/
93+
Os: TargetPlatformOs | undefined;
94+
95+
/**
96+
* <p>Specifies a target platform architecture.</p>
97+
* <ul>
98+
* <li>
99+
* <p>
100+
* <code>X86_64</code>: 64-bit version of the x86 instruction set.</p>
101+
* </li>
102+
* <li>
103+
* <p>
104+
* <code>X86</code>: 32-bit version of the x86 instruction set.</p>
105+
* </li>
106+
* <li>
107+
* <p>
108+
* <code>ARM64</code>: ARMv8 64-bit CPU.</p>
109+
* </li>
110+
* <li>
111+
* <p>
112+
* <code>ARM_EABIHF</code>: ARMv7 32-bit, Hard Float.</p>
113+
* </li>
114+
* <li>
115+
* <p>
116+
* <code>ARM_EABI</code>: ARMv7 32-bit, Soft Float. Used by Android 32-bit ARM
117+
* platform.</p>
118+
* </li>
119+
* </ul>
120+
* @public
121+
*/
122+
Arch: TargetPlatformArch | undefined;
123+
124+
/**
125+
* <p>Specifies a target platform accelerator (optional).</p>
126+
* <ul>
127+
* <li>
128+
* <p>
129+
* <code>NVIDIA</code>: Nvidia graphics processing unit. It also requires
130+
* <code>gpu-code</code>, <code>trt-ver</code>, <code>cuda-ver</code> compiler
131+
* options</p>
132+
* </li>
133+
* <li>
134+
* <p>
135+
* <code>MALI</code>: ARM Mali graphics processor</p>
136+
* </li>
137+
* <li>
138+
* <p>
139+
* <code>INTEL_GRAPHICS</code>: Integrated Intel graphics</p>
140+
* </li>
141+
* </ul>
142+
* @public
143+
*/
144+
Accelerator?: TargetPlatformAccelerator;
145+
}
146+
67147
/**
68148
* <p>Contains information about the output location for the compiled model and the target
69149
* device that the model runs on. <code>TargetDevice</code> and <code>TargetPlatform</code>
@@ -12269,17 +12349,6 @@ export interface CreateSpaceRequest {
1226912349
SpaceDisplayName?: string;
1227012350
}
1227112351

12272-
/**
12273-
* @public
12274-
*/
12275-
export interface CreateSpaceResponse {
12276-
/**
12277-
* <p>The space's Amazon Resource Name (ARN).</p>
12278-
* @public
12279-
*/
12280-
SpaceArn?: string;
12281-
}
12282-
1228312352
/**
1228412353
* @internal
1228512354
*/

clients/client-sagemaker/src/models/models_2.ts

+14-20
Original file line numberDiff line numberDiff line change
@@ -167,6 +167,17 @@ import {
167167
VendorGuidance,
168168
} from "./models_1";
169169

170+
/**
171+
* @public
172+
*/
173+
export interface CreateSpaceResponse {
174+
/**
175+
* <p>The space's Amazon Resource Name (ARN).</p>
176+
* @public
177+
*/
178+
SpaceArn?: string;
179+
}
180+
170181
/**
171182
* @public
172183
* @enum
@@ -3721,13 +3732,13 @@ export interface DescribeClusterResponse {
37213732
*/
37223733
export interface DescribeClusterNodeRequest {
37233734
/**
3724-
* <p>The string name or the Amazon Resource Name (ARN) of the SageMaker HyperPod cluster in which the instance is.</p>
3735+
* <p>The string name or the Amazon Resource Name (ARN) of the SageMaker HyperPod cluster in which the node is.</p>
37253736
* @public
37263737
*/
37273738
ClusterName: string | undefined;
37283739

37293740
/**
3730-
* <p>The ID of the instance.</p>
3741+
* <p>The ID of the SageMaker HyperPod cluster node.</p>
37313742
* @public
37323743
*/
37333744
NodeId: string | undefined;
@@ -3738,7 +3749,7 @@ export interface DescribeClusterNodeRequest {
37383749
*/
37393750
export interface DescribeClusterNodeResponse {
37403751
/**
3741-
* <p>The details of the instance.</p>
3752+
* <p>The details of the SageMaker HyperPod cluster node.</p>
37423753
* @public
37433754
*/
37443755
NodeDetails: ClusterNodeDetails | undefined;
@@ -9849,23 +9860,6 @@ export interface DescribeProcessingJobRequest {
98499860
ProcessingJobName: string | undefined;
98509861
}
98519862

9852-
/**
9853-
* @public
9854-
* @enum
9855-
*/
9856-
export const ProcessingJobStatus = {
9857-
COMPLETED: "Completed",
9858-
FAILED: "Failed",
9859-
IN_PROGRESS: "InProgress",
9860-
STOPPED: "Stopped",
9861-
STOPPING: "Stopping",
9862-
} as const;
9863-
9864-
/**
9865-
* @public
9866-
*/
9867-
export type ProcessingJobStatus = (typeof ProcessingJobStatus)[keyof typeof ProcessingJobStatus];
9868-
98699863
/**
98709864
* @internal
98719865
*/

0 commit comments

Comments
 (0)