agentengine service-account create

创建服务帐户。

Synopsis

创建一个服务账号并签发其第一个客户端密钥。

密钥仅显示一次；请立即保存。

使用 POST /api/v1/oauth/token 将客户端 ID 和密钥交换为 1 小时的访问令牌。仅将该令牌发送到明确启用服务帐户身份验证且分配的角色允许的终结点：

curl --fail-with-body --silent --show-error \  --user '<client-id>' \  --data grant_type=client_credentials \  '<base-url>/api/v1/oauth/token' | \jq -er '"Authorization: Bearer " + .access_token' | \curl --fail-with-body --silent --show-error \  --header @- \  '<base-url>/api/v1/<service-account-enabled-resource>'

项目角色包括 PROJECT_OWNER 和 PROJECT_READ_ONLY；组织角色包括 ORG_OWNER、ORG_GROUP_CREATOR 和 ORG_READ_ONLY。仅当组织启用了所有者角色时，才接受 ORG_OWNER；否则服务器会拒绝它。List 和 get 会显示账户的 Atlas 角色。

创建服务账户时，也可以创建配对的 Atlas 服务账户，这需要为组织或项目开启 Atlas 服务账户配对功能。如果该功能处于关闭状态，命令会说明配对账户的情况，并在终端中询问是否开启。传递 --enable-atlas-pairing 参数可在无需提示的情况下开启该功能，例如在脚本中。如果拒绝，或者在没有终端的情况下省略该标志，则不会创建任何内容。创建配对的 Atlas 服务账户时，其 ID 会随结果一起显示。

例子：

agentengine service-account create ci-pipeline --role PROJECT_OWNERagentengine service-account create audit-reader --org-id <org-id> --role ORG_READ_ONLY

agentengine service-account create <name> --role <role> [flags]

选项

    --base-url string              Platform base URL    --context string               Named context to target (see 'agentengine context list')    --description string           Human-readable description    --enable-atlas-pairing         Turn on Atlas service account pairing for the organization or project if it is off, without a prompt. The notice goes to stderr-h, --help                         help for create    --ip-access-list strings       IPs or CIDRs allowed to use the credential (default: unrestricted)    --json                         Output the created service account as JSON    --org-id string                Organization scope for the service account    --project-id string            Project scope for the service account    --role string                  Role granted to the service account (project: PROJECT_OWNER, PROJECT_READ_ONLY; organization: ORG_OWNER, ORG_GROUP_CREATOR, ORG_READ_ONLY)    --secret-expires-in duration   Secret lifetime as a whole number of hours, e.g. 720h (default: server default of 2160h)

从父命令继承的选项

    --log-file string    override log file path    --log-level string   file log verbosity (error|warn|info|debug) (default "info")    --no-log             disable file logging-q, --quiet              silence stderr below error-v, --verbose count      raise stderr verbosity (-v info, -vv debug)

另请参阅

agentengine service-account - 管理服务账户。