# 使用前必读
#### 概述
CodeArts IDE是一个适用于Windows和Linux的集成开发环境（IDE），它将源代码编辑器的简洁性与代码补全和调试等强大的开发工具结合在一起，提供简单易用的编辑、构建、调试能力，可以让您在环境配置上花费更少的时间，节省更多的时间用于实现您的创意。
您可以使用本文档提供的API对CodeArts IDE进行相关操作，如：激活管理。支持的全部操作请参见[API概览](https://support.huaweicloud.com/api-codeartside/codeartside_03_0005.html)。
在调用CodeArts IDE的API之前，请确保已经充分了解CodeArts IDE的相关概念，详细信息请参见[产品介绍](https://support.huaweicloud.com/productdesc-codeartside/codeartside_07_0001.html)。
#### 调用说明
CodeArts IDE提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见[如何调用API](https://support.huaweicloud.com/api-codeartside/codeartside_03_0006.html)。
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=CodeArtsIDE&api=CreateActivationCode)中调用API，查看API请求和返回结果。此外，API Explorer会自动生成相应API调用示例，帮助您使用API。
 #### 终端节点
终端节点即调用API的**请求地址** ，不同服务不同区域的终端节点不同，CodeArts IDE的终端节点如[表1]所示，请您根据业务需要选择对应区域的终端节点。
 表1CodeArts IDE的终端节点 
| **区域名称** | **区域**     | **终端节点（Endpoint）**               | **协议类型** |
|:---|:---|:---|:---|
| 华北-北京四   | cn-north-4 | ide.cn-north-4.myhuaweicloud.com | HTTPS    |
   
#### 约束与限制
详细的限制请参见具体API的说明。
#### 基本概念
- 账号 用户注册华为云时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用其进行日常管理工作。
  
- 用户 由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。
  在[我的凭证](https://console.huaweicloud.com/iam/#/myCredential)下，您可以查看账号ID和用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。
  
- 区域（Region） 从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。
  Region分为通用Region和专属Region：
  - 通用Region指面向公共租户提供通用云服务的Region。
  
  - 专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。
  
  
  详情请参见[区域和可用区](https://support.huaweicloud.com/usermanual-iaas/zh-cn_topic_0184026189.html)。
  
- 可用区（AZ，Availability Zone） 一个AZ是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。
  
- 项目 华为云的区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您账号中该区域的所有资源。
  如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中购买资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中资源，使得资源的权限控制更加精确。
  
- 企业项目 企业项目是项目的升级版，针对企业不同项目间资源的分组和管理，是逻辑隔离。企业项目中可以包含多个区域的资源，且项目中的资源可以迁入迁出。
  关于企业项目ID的获取及企业项目特性的详细信息，请参见《[企业管理服务用户指南](https://support.huaweicloud.com/usermanual-em/em_am_0006.html)》。