All Products
Search
Document Center

Function Compute:ClaimGPUInstance

Last Updated:Jun 02, 2023

Gets a GPU rendering instance.

Authorization information

There is currently no authorization information disclosed in the API.

Request syntax

POST /2021-04-06/gpuInstances

Request parameters

ParameterTypeRequiredDescriptionExample
bodyobjectNo

The configurations of the GPU rendering instance.

instanceTypestringYes

The specifications of the GPU rendering instance.

ecs.gn7i-c8g1.2xlarge
imageIdstringYes

The image ID of the GPU-rendered instance.

m-foobar
tcpPortRangearrayNo

The range of TCP ports that are open to the security group of the GPU rendering instance.

stringNo

The port range of the TCP protocol.

80/80
udpPortRangearrayNo

The range of UDP ports that are open to the security group of the GPU rendering instance.

stringNo

The port range of the UDP protocol.

13000/13002
sourceCidrIpstringYes

The source IPv4 CIDR block of the GPU rendering instance.

0.0.0.0/0
diskPerformanceLevelstringNo

The disk performance level of the GPU rendering instance.

PL0
passwordstringNo

The password of the GPU rendering instance.

MyPassword
internetBandwidthOutstringNo

The outbound Internet bandwidth of the GPU rendering instance.

100
diskSizeGigabytesstringNo

The system disk space of the GPU rendering instance.

100
vpcIdstringNo

The ID of the VPC in which the instance resides.

v-xxxx
vswIdstringNo

The ID of the vSwitch.

vsw-xxxx
sgIdstringNo

The ID of the security group.

sg-xxxx
rolestringNo

The role of the user.

acs:ram::1234567890:role/fc-test
X-Fc-Account-IdstringNo

The ID of your Alibaba Cloud account.

188077086902****
X-Fc-DatestringNo

The time on which the function is invoked. The format of the value is: EEE,d MMM yyyy HH:mm:ss GMT.

Sat, 14 Jul 2017 07:02:38 GMT
X-Fc-Trace-IdstringNo

The custom request ID.

test-trace-id

Response parameters

ParameterTypeDescriptionExample
object

The data returned.

publicIpstring

The public IP address of the server.

0.0.0.0
instanceIdstring

The ID of the instance that you query.

i-xxx
createdTimestring

The time when the product instance is created.

2022-11-11 07:31:04.899465017 +0000 UTC m=+37.671563424

Examples

Sample success responses

JSONformat

{
  "publicIp": "0.0.0.0",
  "instanceId": "i-xxx",
  "createdTime": "2022-11-11 07:31:04.899465017 +0000 UTC m=+37.671563424"
}

Error codes

For a list of error codes, visit the Service error codes.