Service-Account-Mitglied eines Workspace erstellen

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

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

Erfordert ein OAuth-Zugriffstoken mit dem Scope org:admin, über ant auth login --scope org:admin oder eine Workload-Identity-Federation-Regel; Admin-API-Keys werden nicht akzeptiert. Siehe WIF mit der Admin API verwalten.

Fügt einen Service-Account mit der angegebenen workspace_role zu einem Workspace hinzu.

Die Rolle bestimmt, was der Service-Account im Workspace tun kann und welche Workspace-bezogenen Berechtigungen ihm bei der Authentifizierung über Federation gewährt werden können. Jeder Service-Account ist bereits implizites workspace_user-Mitglied des Standard-Workspace; durch explizites Hinzufügen wird eine gewählte Rolle zugewiesen. Wenn der Service-Account bereits explizites Mitglied des Workspace ist, wird seine workspace_role durch den hier angegebenen Wert ersetzt. Archivierte Workspaces geben 400 zurück. Archivierte Service-Accounts können nicht hinzugefügt werden und werden abgelehnt.

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"

Service-Account-Mitglied eines Workspace erstellen

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"
}