サービスアカウントのワークスペースメンバーを作成

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またはワークロードアイデンティティフェデレーションルールから取得します。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"
}