创建项目

项目是 Cloud de Confiance by S3NS 资源 层次结构中的基本操作单元。项目存在于文件夹（或组织）与虚拟机和存储空间等资源之间。本页面介绍了如何使用 Cloud Resource Manager API 和 Cloud de Confiance 控制台创建 Cloud de Confiance 项目。

项目的关键特征包括：

• 主要服务容器：项目是启用所有 Cloud de Confiance by S3NS 服务 (API) 的基本层级，也是创建 Compute Engine 实例或 BigQuery 数据集等资源的位置。

• 信任边界：项目充当隔离层。默认情况下，一个项目中的资源无权访问另一个项目中的资源，从而为不同的应用或环境建立安全边界。

• 结算单元：项目是企业跟踪、整理和分离组织内费用的主要方式。

• 政策附加点：虽然政策通常从文件夹继承，但项目级是向开发者和服务账号授予特定权限 (Identity and Access Management (IAM)) 以执行日常任务的最常见位置。

准备工作

如需了解项目资源，请参阅 资源层次结构概览。如需获得有关设置资源层次结构的指导，请参阅 确定着陆区的资源层次结构 Cloud de Confiance 。

以下标识符用于您的项目：

• 项目名称：人类可读的项目名称。

  任何 Google API 都不会使用项目名称。您可以在项目创建期间或之后随时修改项目名称。项目名称不必具有唯一性。

• 项目 ID：项目的全局唯一标识符。

  项目 ID 是一个唯一字符串，用于将您的项目与所有 其他项目区分开来 Cloud de Confiance by S3NS。输入项目名称后， Cloud de Confiance 控制台会生成一个唯一的项目 ID，该 ID 可以是 字母、数字和连字符的组合。您可以使用生成的项目 ID，但可以在项目创建期间对其进行修改。项目创建后，项目 ID 将永久保留。

  项目 ID 必须满足以下要求：

  • 长度必须介于 6 到 30 个字符之间。
  • 只能包含小写字母、数字和连字符。
  • 必须以字母开头。
  • 不能以连字符结尾。
  • 不得使用正在或以前使用过的项目 ID；这包括已删除的项目。
  • 不能包含受限字符串，例如 google 和 ssl。避免在项目 ID 中使用 undefined 和 null 等字符串。

  所有 Cloud de Confiance 项目 ID 都自动添加 s3ns: 作为前缀。

• 项目编号：项目编号是系统为项目自动生成的 唯一标识符。

请勿在项目名称、项目 ID 或其他资源名称中添加敏感信息，例如个人身份信息或安全数据。项目 ID 会显示在许多其他 Cloud de Confiance by S3NS 资源的名称中。引用项目或其资源会公开项目 ID 和资源名称。

创建项目

您必须拥有 resourcemanager.projects.create 权限才能创建项目。此权限包含在 Project Creator 角色 (roles/resourcemanager.projectCreator) 等角色中。

如需了解如何向个人授予该角色以及如何限制组织资源范围的访问权限，请参阅管理默认组织角色页面。

如果您未指定父资源，则系统会根据用户账号的网域自动选择父资源（如果适用）。

您可以使用 Cloud de Confiance 控制台、 Google Cloud CLI 或 projects.create() 方法创建新项目。

POST https://cloudresourcemanager.googleapis.com/v3/projects/
Authorization: *************
Content-Type: application/json

{
    "projectId": "our-project-123",
    "name": "my project",
    "labels": {
      "mylabel": "prod"
    }
}

{
    "name": "operations/pc.123456789",
}

GET https://cloudresourcemanager.googleapis.com/v3/operations/pc.123456789
Authorization: *************
Content-Type: application/json

{
    "name": "operations/pc.123456789",
    "done": true,
    "response": {
        "@type": "type.googleapis.com/google.cloudresourcemanager.v3.Project",
        "projectNumber": "464036093014",
        "projectId": "our-project-123",
        "lifecycleState": "ACTIVE",
        "name": "my project",
        "labels": {
        "mylabel": "prod"
        },
    "createTime": "2016-01-07T21:59:43.314Z"
    }
}

在项目创建期间添加标记

标记提供了一种为资源创建注解的方法。您可以在创建项目时添加标记。添加标记时，您 必须分配Tag User角色。如需详细了解分配给此角色的权限，请参阅管理资源上的标记。您只能通过以下方式之一添加标记键值对的命名空间：

gcloud projects create PROJECT_ID --organization=ORGANIZATION_ID --tags=KEY_VALUE_PAIRS

  POST https://cloudresourcemanager.googleapis.com/v3/projects/
  Authorization: *************
  Content-Type: application/json

  {
    "projectId": "our-project-456",
    "name": "my project",
    "parent": "organizations/123",
    "tags": {
      "key": "123/environment"
      "value": "production"
    },
"tags": {
      "key": "123/costCenter"
      "value": "marketing"
  }
}

使用标记指定项目环境

您可以使用标记根据项目环境（例如生产环境、预演环境或开发环境）以直观方式区分项目。这有助于防止错误，并在您在敏感环境中工作时提高意识。当选择具有特定标记键值对的项目时，Google 会在 控制台项目选择器 中为项目添加 Cloud de Confiance 指示图标。此指示图标会提醒您，任何更改都可能会影响关联的生产应用或非生产应用。标记可以由项目继承，也可以直接在项目上设置。

如需使用此功能，请执行以下操作：

1. 创建一个名为 environment 的标记键。
2. 为您使用的环境类别创建标记值。控制台项目选择器中支持以下值，并会将其映射到相应的徽章：
   • Prod：Prod、prod、生产环境、production
   • Dev：Dev、dev、Development、development
   • Test：Test、test、Testing、testing、质量保证、质量保证、质量保证、质量保证
   • Staging：Staging、staging、Stage、stage
3. 通过 创建标记绑定，将适当的标记附加到您的项目。

如果一个项目有多个环境标记（例如，一个从文件夹继承，一个直接在项目上），则使用最具体的标记来确定徽章。

使用服务帐号创建项目

您可以使用服务帐号自动创建项目。与用户账号一样，您可以向服务账号授予在组织资源中创建项目的权限。使用服务账号时，您无法在组织资源外部创建项目，并且必须在创建项目时指定父资源。 服务账号可以使用 gcloud CLI 或 projects.create() 方法创建新项目。

管理项目配额

如需为组织配额中的项目申请额外容量，请向 团队提交支持服务工单。 Cloud de Confiance by S3NS 如需了解详情， 请参阅申请配额调整。

后续步骤

• 了解如何查看和更新项目。
• 了解如何删除和恢复项目。
• 了解如何在资源层次结构中移动项目。
• 了解如何将项目从一个组织资源迁移到另一个组织资源。