组织 ORGANIZATIONS-华为云

组织 ORGANIZATIONS-使用前必读:基本概念

基本概念账号用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用用户进行日常管理工作。账号用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用用户进行日常管理工作。用户由账号在 IAM 中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。在我的凭证下，您可以查看账号ID和IAM用户ID。通常在调用API的鉴权过程中，您需要用到账号账号、用户和密码等信息。区域（Region）指云资源所在的物理位置，同一区域内可用区间内网互通，不同区域间内网不互通。通过在不同地区创建云资源，可以将应用程序设计的更接近特定客户的要求，或满足不同地区的法律或其他要求。从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。详情请参见区域和可用区。可用区（AZ，Availability Zone）一个可用区是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。项目区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您账号账号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中创建资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中的资源，使得资源的权限控制更加精确。图1 项目隔离模型同样在我的凭证下，您可以查看项目ID。企业项目企业项目是项目的升级版，针对企业不同项目间的资源进行分组和管理，是逻辑隔离。企业项目中可以包含多个区域的资源，且项目中的资源可以迁入迁出。关于企业项目ID的获取及企业项目特性的详细信息，请参见《企业管理用户指南》。

组织 ORGANIZATIONS

组织 ORGANIZATIONS-使用前必读:终端节点

终端节点终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 Organizations的终端节点如表1所示。Organizations是全局级服务，数据全局一份，在全局项目中存储，Organizations所有的API都可以使用全局服务的Endpoint调用。表1 Organizations的终端节点区域名称区域终端节点（Endpoint） All All organizations.myhuaweicloud.com

组织 ORGANIZATIONS

组织 ORGANIZATIONS-创建账号:请求示例

请求示例创建账号 POST https://{endpoint}/v1/organizations/accounts { "name" : "C9Qzukfn6FIyxAmC3dQclrwZW34UDu_rPSRrCQ4aGFm0-r1zC2RDHt5oHA-aY21B", "tags" : [ { "key" : "keystring", "value" : "valuestring" } ] }

组织 ORGANIZATIONS

组织 ORGANIZATIONS-创建账号:响应示例

响应示例状态码： 202 Successful { "create_account_status" : { "account_id" : "0a6d25d23900d45c0faac010e0fb4de0", "account_name" : "paas_iam_573331", "completed_at" : "2022-08-24T06:41:15Z", "created_at" : "2022-08-24T06:41:15Z", "id" : "h-awjp43m7bz3b8jgy5v61jrfwakt3og8w", "state" : "in_progress", "failure_reason" : "string" } }

组织 ORGANIZATIONS

组织 ORGANIZATIONS-创建账号:请求参数

请求参数表1 请求Header参数参数是否必选参数类型描述 X-Security-Token 否 String 如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。表2 请求Body参数参数是否必选参数类型描述 name 是 String 账号名称 email 否 String 邮箱 phone 否 String 手机号码 agency_name 否 String 委托名称 description 否 String 描述信息。

组织 ORGANIZATIONS

组织 ORGANIZATIONS-创建账号:响应参数

响应参数状态码： 202 表3 响应Body参数参数参数类型描述 create_account_status CreateAccountStatusDto object 包含有关在组织中创建账号的CreateAccount请求的状态。表4 CreateAccountStatusDto 参数参数类型描述 account_id String 如果账号创建成功，则为新账号的唯一标识符（ID）。 account_name String 账号名称 completed_at String 创建账号和完成请求的日期和时间。 created_at String 请求创建账号的日期和时间。 id String 请求的唯一标识符（ID）。您可以从创建账号的初始CreateAccount请求的响应中获得此值。 state String 创建账号的异步请求的状态，in_progress：处理中，succeeded：成功，failed：失败。 failure_reason String 如果请求失败，则说明失败原因。

组织 ORGANIZATIONS

组织 ORGANIZATIONS-查询有关创建账号状态的信息:响应示例

响应示例状态码： 200 Successful { "create_account_status" : { "account_id" : "0a6d25d23900d45c0faac010e0fb4de0", "account_name" : "paas_iam_573331", "completed_at" : "2022-08-24T06:41:15Z", "created_at" : "2022-08-24T06:41:15Z", "id" : "h-awjp43m7bz3b8jgy5v61jrfwakt3og8w", "state" : "in_progress", "failure_reason" : "string" } }

组织 ORGANIZATIONS

组织 ORGANIZATIONS-查询有关创建账号状态的信息:响应参数

响应参数状态码： 200 表3 响应Body参数参数参数类型描述 create_account_status CreateAccountStatusDto object 包含有关在组织中创建账号的CreateAccount请求的状态。表4 CreateAccountStatusDto 参数参数类型描述 account_id String 如果账号创建成功，则为新账号的唯一标识符（ID）。 account_name String 账号名称 completed_at String 创建账号和完成请求的日期和时间。 created_at String 请求创建账号的日期和时间。 id String 请求的唯一标识符（ID）。您可以从创建账号的初始CreateAccount请求的响应中获得此值。 state String 创建账号的异步请求的状态，in_progress：处理中，succeeded：成功，failed：失败。 failure_reason String 如果请求失败，则说明失败原因。

组织 ORGANIZATIONS

组织 ORGANIZATIONS-根据资源类型及标签信息查询实例数量:请求示例

请求示例根据资源类型及标签信息查询实例数量 POST https://{endpoint}/v1/organizations/{resource_type}/resource-instances/count { "without_any_tag" : true, "tags" : [ { "key" : "string", "values" : [ "string" ] } ], "matches" : [ { "key" : "string", "value" : "string" } ] }

组织 ORGANIZATIONS

组织 ORGANIZATIONS-根据资源类型及标签信息查询实例数量:URI

URI POST https://{endpoint}/v1/organizations/{resource_type}/resource-instances/count 表1 路径参数参数是否必选参数类型描述 resource_type 是 String 资源类型。枚举值：organizations:policies（服务策略）、organizations:ous（组织OU）、organizations:accounts（账号信息）、organizations:roots：（根）。

组织 ORGANIZATIONS

组织 ORGANIZATIONS-根据资源类型及标签信息查询实例数量:请求参数

请求参数表2 请求Header参数参数是否必选参数类型描述 X-Security-Token 否 String 如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。表3 请求Body参数参数是否必选参数类型描述 without_any_tag 否 Boolean 不包含任意一个标签，该字段为true时查询所有不带标签的资源。 tags 否 Array of TagsDTO objects 包含标签，最多包含10个key，每个key下面的value最多10个，结构体不能缺失，key不能为空或者空字符串。Key不能重复，同一个key中values不能重复。返回包含所有标签的资源列表，key之间是与的关系，key-value结构中value是或的关系。无tag过滤条件时返回全量数据。表4 TagsDTO 参数是否必选参数类型描述 key 是 String 键。最大长度127个unicode字符。 key不能为空。 values 是 Array of strings 值列表。每个值最大长度255个unicode字符。

组织 ORGANIZATIONS

组织 ORGANIZATIONS-创建组织单元:请求参数

请求参数表1 请求Header参数参数是否必选参数类型描述 X-Security-Token 否 String 如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。表2 请求Body参数参数是否必选参数类型描述 name 是 String 要分配给新组织单元的名称。 parent_id 是 String 要在其中创建新组织单元的根或组织单元的唯一标识符。

组织 ORGANIZATIONS 组织单元管理

组织 ORGANIZATIONS-创建组织单元:响应参数

响应参数状态码： 201 表3 响应Body参数参数参数类型描述 organizational_unit OrganizationalUnitDto object 包含有关新创建的组织单元的详细信息的结构。表4 OrganizationalUnitDto 参数参数类型描述 id String 与组织单元关联的唯一标识符（ID）。 urn String 组织单元的统一资源名称。 name String 组织单元的名称。 created_at String 组织单元的创建时间。

组织 ORGANIZATIONS 组织单元管理

组织 ORGANIZATIONS-创建组织单元:响应示例

响应示例状态码： 201 Successful { "organizational_unit" : { "id" : "ou-fi0rv9jbjgc6nifokh65jjo8c24fnujv", "urn" : "organizations::0a6d25d23900d45c0faac010e0fb4de0:ou:o-fhkmi6mek7wlqdp6nideqhb47qwtjdsv/ou-fi0rv9jbjgc6nifokh65jjo8c24fnujv", "name" : "autoOU0923152728692gqQc", "created_at" : "2022-09-23T07:27:28Z" } }

组织 ORGANIZATIONS 组织单元管理

组织 ORGANIZATIONS-创建组织单元:请求示例

请求示例创建组织单元 POST https://{endpoint}/v1/organizations/organizational-units { "name" : "autoOU0923152728692gqQc", "parent_id" : "ou-kz0blhbszb6w9a2lzb", "tags" : [ { "key" : "keystring", "value" : "keystring" } ] }

组织 ORGANIZATIONS 组织单元管理

云服务器内容精选

组织 ORGANIZATIONS

7*24

备案

专业服务

退订

建议反馈

售前咨询热线