서비스 계정 워크스페이스 멤버 생성

client.Organization.Workspaces.ServiceAccounts.Add(ctx, workspaceID, body) (*ServiceAccountWorkspaceMember, error)

POST/v1/organizations/workspaces/{workspace_id}/service_accounts

org:admin 범위가 있는 OAuth 액세스 토큰이 필요합니다. 이 토큰은 ant auth login --scope org:admin 또는 워크로드 ID 페더레이션 규칙에서 얻을 수 있으며, Admin API 키는 허용되지 않습니다. Admin API로 WIF 관리를 참조하세요.

지정된 workspace_role로 서비스 계정을 워크스페이스에 추가합니다.

역할은 서비스 계정이 워크스페이스에서 수행할 수 있는 작업과 페더레이션을 통해 인증할 때 부여받을 수 있는 워크스페이스 범위 권한을 결정합니다. 모든 서비스 계정은 이미 기본 워크스페이스의 암묵적 workspace_user 멤버이며, 명시적으로 추가하면 선택한 역할이 할당됩니다. 서비스 계정이 이미 워크스페이스의 명시적 멤버인 경우, 해당 workspace_role이 여기에 제공된 값으로 대체됩니다. 보관된 워크스페이스는 400을 반환합니다. 보관된 서비스 계정은 추가할 수 없으며 거부됩니다.

Parameters

workspaceID string⁠Path

ID of the workspace.

body OrganizationWorkspaceServiceAccountAddParams

ServiceAccountID string

Tagged service account ID to add.

WorkspaceRole NoBillingWorkspaceRole

Role to assign to the service account in this workspace.

Returns

type ServiceAccountWorkspaceMember struct { Type: "service_account_workspace_member"; CreatedByActorID; Implicit; /* 3 more */ }

Type ServiceAccountWorkspaceMember

defaultservice_account_workspace_member

CreatedByActorID string

Tagged ID (user_.../svac_...) of the actor who created this membership.

Implicit bool

True when this is the implicit default-workspace membership every service account has when no explicit membership exists. Implicit memberships have role workspace_user and cannot be removed.

ServiceAccountID string

Tagged service account ID (svac_...).

WorkspaceID string

Tagged workspace ID (wrkspc_...).

WorkspaceRole WorkspaceRole

Role of the service account in this workspace. Service accounts cannot hold the workspace_billing role.

One of the following:

const WorkspaceRoleWorkspaceAdmin WorkspaceRole = "workspace_admin"

const WorkspaceRoleWorkspaceBilling WorkspaceRole = "workspace_billing"

const WorkspaceRoleWorkspaceDeveloper WorkspaceRole = "workspace_developer"

const WorkspaceRoleWorkspaceRestrictedDeveloper WorkspaceRole = "workspace_restricted_developer"

const WorkspaceRoleWorkspaceUser WorkspaceRole = "workspace_user"

서비스 계정 워크스페이스 멤버 생성

package main

import (
	"context"
	"fmt"

	"github.com/anthropics/anthropic-sdk-go"
	"github.com/anthropics/anthropic-sdk-go/option"
)

func main() {
	client := anthropic.NewClient(
		option.WithAPIKey("my-anthropic-api-key"),
	)
	serviceAccountWorkspaceMember, err := client.Organization.Workspaces.ServiceAccounts.Add(
		context.TODO(),
		"workspace_id",
		anthropic.OrganizationWorkspaceServiceAccountAddParams{
			ServiceAccountID: "service_account_id",
			WorkspaceRole:    anthropic.NoBillingWorkspaceRoleWorkspaceAdmin,
		},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", serviceAccountWorkspaceMember.CreatedByActorID)
}

Response 200

{
  "created_by_actor_id": "created_by_actor_id",
  "implicit": true,
  "service_account_id": "service_account_id",
  "type": "service_account_workspace_member",
  "workspace_id": "workspace_id",
  "workspace_role": "workspace_admin"
}

Returns Examples

Response 200

{
  "created_by_actor_id": "created_by_actor_id",
  "implicit": true,
  "service_account_id": "service_account_id",
  "type": "service_account_workspace_member",
  "workspace_id": "workspace_id",
  "workspace_role": "workspace_admin"
}