tencent cloud

PrevNext

Feedback

search by keyword

Recent Pages

Documentation
Documentation

CreateSite

Last updated: 2024-11-27 15:19:32

1. API Description

Domain name for API request: cdc.intl.tencentcloudapi.com.

This API is used to create a site.

A maximum of 20 requests can be initiated per second for this API.

We recommend you to use API Explorer
Try it
API Explorer provides a range of capabilities, including online call, signature authentication, SDK code generation, and API quick search. It enables you to view the request, response, and auto-generated examples.

2. Input Parameters

The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.

Parameter Name Required Type Description
Action Yes String Common Params. The value used for this API: CreateSite.
Version Yes String Common Params. The value used for this API: 2020-12-14.
Region Yes String Common Params. For more information, please see the list of regions supported by the product.
Name Yes String Site name
Country Yes String Country where the site is located
Province Yes String Province where the site is located
City Yes String City where the site is located
AddressLine Yes String Detailed address of the site
Description No String Site description
Note No String Note
FiberType No String You are using optical fiber type to connect the CDC device to the network Single-mode or multi-mode fibers are available.
OpticalStandard No String Optical standard used to connect the CDC device to the network This field depends on the uplink speed, optical fiber type, and distance to upstream equipment.
PowerConnectors No String Type of power connector
PowerFeedDrop No String Whether power is supplied from above or below the rack
MaxWeight No Integer Maximum weight capacity (KG)
PowerDrawKva No Integer Power consumption (KW)
UplinkSpeedGbps No Integer Uplink speed from the network to Tencent Cloud Region
UplinkCount No Integer Number of uplinks used by each CDC device (2 devices per rack) when connected to the network
ConditionRequirement No Boolean Whether the following environmental conditions are met:
1. There are no material requirements or the acceptance standard on site that will affect the delivery and installation of the CDC device.
2. The following conditions are met for finalized rack positions:
Temperature ranges from 41 to 104°F (5 to 40°C).
Humidity ranges from 10°F (-12°C) to 70°F (21°C) and relative humidity ranges from 8% RH to 80% RH.
Air flows from front to back at the rack position and there is sufficient air in CFM (cubic feet per minute). The air quantity in CFM must be 145.8 times the power consumption (in KVA) of CDC.
DimensionRequirement No Boolean Whether the following dimension conditions are met:
Your loading dock can accommodate one rack container (H x W x D = 94" x 54" x 48").
You can provide a clear route from the delivery point of your rack (H x W x D = 80" x 24" x 48") to its final installation location. You should consider platforms, corridors, doors, turns, ramps, freight elevators as well as other access restrictions when measuring the depth.
There shall be a 48" or greater front clearance and a 24" or greater rear clearance where the CDC is finally installed.
RedundantNetworking No Boolean Whether redundant upstream equipment (switch or router) is provided so that both network devices can be connected to the network.
PostalCode No Integer Postal code of the site area
OptionalAddressLine No String Detailed address of the site area (to be added)
NeedHelp No Boolean Whether you need help from Tencent Cloud for rack installation?
RedundantPower No Boolean Whether there is power redundancy?
BreakerRequirement No Boolean Whether there is an upstream circuit breaker?

3. Output Parameters

Parameter Name Type Description
SiteId String Created Site id
RequestId String The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.

4. Example

Example1 Creating a site.

This example shows you how to create a site.

Input Example

https://cdc.intl.tencentcloudapi.com/?Action=CreateSite
&Name=my-site
&Description=firstsite
&Note=newsite
&FiberType=MM
&OpticalStandard=1000Base-SX
&PowerConnectors=2
&PowerFeedDrop=above
&MaxWeight=500
&PowerDrawKva=3000
&UplinkSpeedGbps=10
&UplinkCount=2
&ConditionRequirement=True
&DimensionRequirement=True
&RedundantNetworking=True
&Country=China
&Province=Guangdong
&City=Shenzhen
&PostalCode=51800
&AddressLine=nanshan
&OptionalAddressLine=tengda
&BreakerRequirement=True
&RedundantPower=True
&NeedHelp=True
&<Common request parameters>

Output Example

{
    "Response": {
        "SiteId": "site-c738dj",
        "RequestId": "d39d6c09-44e9-4e80-8661-77b5ff3cbc16"
    }
}

5. Developer Resources

SDK

TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.

Command Line Interface

6. Error Code

The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.

Error Code Description
InvalidParameterValue.InvalidAppIdFormat The returned value of ccdb is not 0.
InvalidParameterValue.TooLong The parameter name is too long.
Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
Privacy PolicyLegalCookie Policy