试用版和标准版

“[试用版”和“标准版]”{: tag-blue} 计划在以下地区提供。

Vault 专用套餐

Vault 专用 可在以下区域使用。

Vault Dedicated 套餐目前处于公开测试阶段。 Beta 功能仅供评估和测试使用，与已正式发布的功能相比存在某些限制。

试用版和标准版计划的服务端点

如果您需要管理 Secrets Manager 资源，请参考下表，以确定连接到 Secrets Manager API时应使用的API端点。

要了解如何配置 Secrets Manager 实例以使用专用端点，请参阅 确保与 Secrets Manager 的连接安全。

准备好试用 API 了吗? 要从浏览器与 Swagger UI 交互，请将 api/v2/swagger-ui 添加到服务端点 URL。 例如，https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/swagger-ui。

Vault Dedicated 套餐的服务端点

Vault 专用 方案为每个实例提供两个私有端点 URL：一个用于 Vault API，另一个用于 Vault UI。 两者均只能通过 VPE 网关访问——此套餐不支持云服务端点（CSE）。

请将 {instance_ID} 替换为您实例的 UUID，并将 {region} 替换为区域缩写，例如 us-south 或 eu-de。

如果您的实例配置了仅限私有端点，则适用以下访问要求：

• API 访问：需要一个指向您的 Vault Dedicated 实例的 VPE 网关。 有关设置说明，请参阅《 使用服务端点私有连接至 Secrets Manager 》。
• Vault UI 访问：需要使用客户端到站点（Client-to-Site）VPN，该 VPN 需将流量通过 VPE 进行路由。 浏览器无法直接从 IBM Cloud 私有网络外部访问私有Vault用户界面 URL。 有关设置说明，请参阅《 使用客户端到站点 VPN 私有连接到 Secrets Manager 》。

如果您的实例配置了公共和私有端点，则无需 VPE 或 VPN，即可通过公共互联网访问 Vault API 和 Vault UI。 私有端点 URL 同样可用，但使用它们仍需 VPE 网关（以及用于访问 Vault UI 的客户端到站点 VPN），这与上文对“仅私有”实例的描述完全一致。

您可以通过 Secrets Manager 用户界面的 “端点”页面，或调用 实例详细信息API，获取该实例的确切端点URL。

查看端点 URL

您可以在 Secrets Manager UI 的“端点”页面中找到服务端点 URL。

专用控制平面端点可通过 VPE 网关访问。 有关更多信息，请参阅 使用服务端点私下连接 Secrets Manager。 如果需要以编程方式检索服务端点 URL，那么还可以调用以下 API 来检索特定于 Secrets Manager 实例的值。

curl -X GET  
    -H "Accept: application/json" \
    -H "Authorization: Bearer {IAM_token}"
"https://{region}.secrets-manager.cloud.ibm.com/api/v1/instances/{url_encoded_instance_CRN}/endpoints"

根据下表替换示例请求中的变量。

成功请求将返回与您指定的区域和服务实例 CRN 相关联的端点 URL。 以下 JSON 代码片段展示了一个响应示例。

{
    "plan": "standard",
    "public_endpoints": {
        "service_api": "https://927fb8ae-1ddd-4483-a21f-7d3c0fc81234.us-south.secrets-manager.appdomain.cloud/api",
        "vault_api": "https://927fb8ae-1ddd-4483-a21f-7d3c0fc81234.us-south.secrets-manager.appdomain.cloud"
    },
    "private_endpoints": {
        "service_api": "https://927fb8ae-1ddd-4483-a21f-7d3c0fc1234.private.us-south.secrets-manager.appdomain.cloud/api",
        "vault_api": "https://927fb8ae-1ddd-4483-a21f-7d3c0fc81234.private.us-south.secrets-manager.appdomain.cloud"
    },
    "encryption": {
      "provider_managed_encryption": "key_protect",  
      "encryption_key_crn": "crn:v1:staging:public:kms:us-south:a/791f5fb10986423e97aa8512f181234:31639268-42e8-4420-9872-590a6ee21234:key:b4af8f76-e6ea-4dc5-89cc-5f1b9bb1234"
    }
}

控制平面端点

使用以下控制平面端点调用控制平面 API。

专用控制平面端点可通过 VPE 网关访问。 有关更多信息，请参阅 使用服务端点私下连接 Secrets Manager。

要尝试此 API，可以从浏览器与以下 Swagger UI 进行交互: https://{region}.secrets-manager.cloud.ibm.com/swagger-ui。

如果使用 仅专用 选项配置实例，那么此 API 仅返回响应中的 private_endpoints 对象。