翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

WorkSpaces

AWS の Claude プラットフォームでの推論リクエストとリソースリクエストは、ワークスペースをターゲットにします。これらの API コールの anthropic-workspace-idヘッダーでワークスペースの ID を渡します。WorkSpace IDsは、タグ付けされた形式wrkspc_に続けて英数字識別子 (例: ) を使用しますwrkspc_01AbCdEf23GhIj。ワークスペース ID をまだお持ちでない場合は、「ワークスペース ID を取得する」を参照してください。

WorkSpace スコープ

WorkSpaces は 1 つの AWS リージョンにバインドされます。で作成されたワークスペースには、 us-west-2エンドポイントを介してus-west-2のみアクセスできます。使用量、クォータ、コスト、ファイル、バッチ、スキルはすべてワークスペースごとにロールアップされるため、Claude コンソールでリージョンごとの内訳を確認できます。

WorkSpaces は、AWS 上の Claude プラットフォームのプライマリ IAM リソースとしても機能します。ワークスペース ARN を使用して、AWS IAM ポリシーを通じて特定のワークスペースへのアクセスを許可または拒否します。ARN のリソースセグメントは、anthropic-workspace-idヘッダーで渡す wrkspc_プレフィックス付き ID と同じです。

arn:aws:aws-external-anthropic:{region}:{account-id}:workspace/{workspace-id}

例: arn:aws:aws-external-anthropic:us-west-2:123456789012:workspace/wrkspc_01AbCdEf23GhIj

ポリシーの例については、「IAM ポリシー」を参照してください。

ワークスペースの作成

デフォルトのワークスペースはサインアップ時に自動的にプロビジョニングされます。追加のワークスペースは、対応するaws-external-anthropicアクション (、CreateWorkspace、ArchiveWorkspace) によって承認された/v1/organizations/workspacesエンドポイントを介して作成、更新、名前変更UpdateWorkspace、アーカイブできます。「IAM アクション」を参照してください。

クライアントでのワークスペース ID の設定

すべてのデータプレーンリクエストには、 anthropic-workspace-idヘッダーにワークスペース ID を含める必要があります。Anthropic SDK の Claude-on-AWS クライアントを使用する場合は、次の 3 つの方法があります。

ベースAnthropicクライアント (AWS バックエンドなし) を使用する場合は、すべてのリクエストで anthropic-workspace-idヘッダーを明示的に設定します。「言語ごとのリクエストの実行例」を参照してください。SDK 固有の引数名については、Anthropic Client SDKsを参照してください。

ワークスペースのタグ付け

ワークスペースタグは、ワークスペースにアタッチされたキーと値のペアです。属性ベースのアクセスコントロールのために AWS IAM と統合され、コスト配分のために AWS コストと使用状況レポートと統合されます (CUR の詳細については「モニタリングとログ記録」を参照）。タグ付けは AWS の Claude プラットフォームでは GA です。

既存のワークスペースのタグをaws-external-anthropic名前空間の TagResourceと UntagResource で更新します。同じタグキーを使用すると、追加の設定なしで IAM 条件とコスト配分を駆動できます。

タグベースのアクセス制御

aws:ResourceTag/<key> 条件コンテキストキーを使用して、ワークスペースタグ値に対するaws-external-anthropicアクションをゲートできます。次のポリシーでは、 にタグ付けされたワークスペースでのみ推論を許可しますEnvironment=production。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-external-anthropic:CreateInference",
        "aws-external-anthropic:CreateBatchInference",
        "aws-external-anthropic:CountTokens"
      ],
      "Resource": "arn:aws:aws-external-anthropic:*:*:workspace/*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceTag/Environment": "production"
        }
      }
    }
  ]
}

で aws:RequestTag/<key>および aws:TagKeys条件キーTagResourceを使用して、タグ付けポリシーを適用します (ワークスペースに CostCenterおよび Owner タグを渡すように要求するなど）。その他の例については、「IAM ポリシー」を参照してください。