> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-update-reference-docs-60.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Registry

export const GitHubLink = ({url, compact = false}) => <a href={url} target="_blank" rel="noopener noreferrer" className={compact ? "source-link" : "github-source-link"}>
    {compact ? "ソースを表示" : <>
    <svg width="20" height="20" viewBox="0 0 24 24" fill="currentColor" xmlns="http://www.w3.org/2000/svg">
      <path d="M12 0C5.37 0 0 5.37 0 12c0 5.31 3.435 9.795 8.205 11.385.6.105.825-.255.825-.57 0-.285-.015-1.23-.015-2.235-3.015.555-3.795-.735-4.035-1.41-.135-.345-.72-1.41-1.23-1.695-.42-.225-1.02-.78-.015-.795.945-.015 1.62.87 1.845 1.23 1.08 1.815 2.805 1.305 3.495.99.105-.78.42-1.305.765-1.605-2.67-.3-5.46-1.335-5.46-5.925 0-1.305.465-2.385 1.23-3.225-.12-.3-.54-1.53.12-3.18 0 0 1.005-.315 3.3 1.23.96-.27 1.98-.405 3-.405s2.04.135 3 .405c2.295-1.56 3.3-1.23 3.3-1.23.66 1.65.24 2.88.12 3.18.765.84 1.23 1.905 1.23 3.225 0 4.605-2.805 5.625-5.475 5.925.435.375.81 1.095.81 2.22 0 1.605-.015 2.895-.015 3.3 0 .315.225.69.825.57A12.02 12.02 0 0024 12c0-6.63-5.37-12-12-12z" />
    </svg>
    GitHub のソース
      </>}
  </a>;

<GitHubLink compact url="https://github.com/wandb/wandb/blob/main/wandb/apis/public/registries/registry.py#L36" />

## <Badge color="yellow" size="lg" shape="rounded">クラス</Badge> wandb.apis.public.Registry

Registry 内の 1 つの Registry です。

```python theme={null}
(service_api: 'ServiceApi',
organization: 'str',
entity: 'str',
name: 'str',
attrs: 'RegistryFragment | None' = None)
```

<div id="args">
  ## 引数
</div>

<ResponseField name="service_api" type="ServiceApi">
  説明はありません。
</ResponseField>

<ResponseField name="organization" type="str">
  説明はありません。
</ResponseField>

<ResponseField name="entity" type="str">
  説明はありません。
</ResponseField>

<ResponseField name="name" type="str">
  説明はありません。
</ResponseField>

<ResponseField name="attrs" type="RegistryFragment | None">
  説明はありません。
</ResponseField>

<div id="properties">
  ## プロパティ
</div>

<ResponseField name="allow_all_artifact_types" type="bool">
  Registry ですべてのアーティファクト タイプが許可されているかどうかを返します。

  `True` の場合、任意のタイプのアーティファクトを追加できます。`False` の場合、アーティファクトは
  `artifact_types` にリストされているタイプに制限されます。
</ResponseField>

<ResponseField name="artifact_types" type="AddOnlyArtifactTypesList">
  Registry で許可されているアーティファクト タイプを返します。

  `allow_all_artifact_types` が `True` の場合、`artifact_types` には
  以前に保存されたタイプ、または現在 Registry で使用されているタイプが反映されます。
  `allow_all_artifact_types` が `False` の場合、アーティファクトは
  `artifact_types` のタイプに制限されます。

  注:
  以前に保存されたアーティファクト タイプは削除できません。
</ResponseField>

<ResponseField name="created_at" type="str">
  Registry が作成された時点のタイムスタンプです。
</ResponseField>

<ResponseField name="description" type="str | None">
  Registry の説明です。
</ResponseField>

<ResponseField name="entity" type="str">
  Registry の組織エンティティです。
</ResponseField>

<ResponseField name="full_name" type="str">
  `wandb-registry-` 接頭辞を含む Registry の完全名です。
</ResponseField>

<ResponseField name="id" type="str">
  この Registry の一意の ID です。
</ResponseField>

<ResponseField name="internal_id" type="str | None">
  取得されている場合、この Registry の基盤となる project の GraphQL `internalId` です。

  これは base64 エンコードされたグローバル ID です。デコードすると、
  `Project:123` または `ProjectInternalId:123` のようになります。
</ResponseField>

<ResponseField name="name" type="str">
  `wandb-registry-` 接頭辞を除いた Registry の名です。
</ResponseField>

<ResponseField name="organization" type="str">
  Registry の組織名です。
</ResponseField>

<ResponseField name="path" type="list[str]">
  説明はありません。
</ResponseField>

<ResponseField name="updated_at" type="str | None">
  Registry が最後に更新された時点のタイムスタンプです。
</ResponseField>

<ResponseField name="visibility" type="The visibility level.">
  Registry の可視性です。
</ResponseField>

<div id="methods">
  ## メソッド
</div>

### <Badge color="blue" size="lg" shape="rounded">メソッド</Badge> Registry.add\_members()

```python theme={null}
self, *members: 'User | UserMember | Team | TeamMember | str'
```

この Registry にUsersまたはTeamsを追加します。

<div id="arguments">
  ##### 引数
</div>

<ResponseField name="members" type="User | UserMember | Team | TeamMember | str">
  Registry に追加するUsersまたはTeams。`User` オブジェクト、`Team` オブジェクト、またはそれらの文字列IDを受け付けます。
</ResponseField>

<div id="raises">
  ##### 送出される例外
</div>

* `TypeError`: 引数としてメンバーが1つも渡されなかった場合。
* `ValueError`: ユーザーまたはチームのIDを推定または解析できない場合。

<div id="examples">
  ##### 例
</div>

```python theme={null}
import wandb

api = wandb.Api()

# 既存のレジストリを取得する
registry = api.registry(name="my-registry", organization="my-org")

user1 = api.user(username="some-user")
user2 = api.user(username="other-user")
registry.add_members(user1, user2)

my_team = api.team(name="my-team")
registry.add_members(my_team)
```

### <Badge color="blue" size="lg" shape="rounded">メソッド</Badge> Registry.collections()

```python theme={null}
self,
filter: 'dict[str, Any] | None' = None,
order: 'str | None' = None,
per_page: 'PositiveInt' = 100,
start: 'str | None' = None
```

この Registry に属するコレクションを返します。

<div id="arguments">
  ##### 引数
</div>

<ResponseField name="filter" type="dict[str, Any] | None">
  コレクションのクエリに適用するフィルターのマッピング (省略可) 。
</ResponseField>

<ResponseField name="order" type="str | None">
  結果の並び順を指定する string (省略可) 。先頭に '+' を付けると昇順 (デフォルト) 、'-' を付けると降順で並べ替えます。
</ResponseField>

<ResponseField name="per_page" type="PositiveInt">
  1 ページあたりに取得する結果数です。通常、これを変更する必要はありません。
</ResponseField>

<ResponseField name="start" type="str | None">
  過去のクエリを再開するためのページネーションカーソルです。以前のページネーターの `.cursor` 属性から取得します。
</ResponseField>

### <Badge color="blue" size="lg" shape="rounded">メソッド</Badge> Registry.create()

```python theme={null}
api: 'Api',
organization: 'str',
name: 'str',
visibility: "Literal['organization', 'restricted']",
description: 'str | None' = None,
artifact_types: 'list[str] | None' = None
```

新しいRegistryを作成します。

Registry名は、組織内で一意である必要があります。
この関数は `api.create_registry()` を使用して呼び出してください。

<div id="arguments">
  ##### 引数
</div>

<ResponseField name="api" type="Api">
  W\&B API のインスタンス。
</ResponseField>

<ResponseField name="organization" type="str">
  組織名。
</ResponseField>

<ResponseField name="name" type="str">
  Registry の名前 (`wandb-registry-` 接頭辞を除く) 。
</ResponseField>

<ResponseField name="visibility" type="Literal['organization', 'restricted']">
  可視性レベル ('organization' または 'restricted') 。
</ResponseField>

<ResponseField name="description" type="str | None">
  Registry の任意の説明。
</ResponseField>

<ResponseField name="artifact_types" type="list[str] | None">
  許可するアーティファクト タイプの任意のリスト。
</ResponseField>

<div id="raises">
  ##### 送出される例外
</div>

* `ValueError`: 組織内に同じ名のRegistryがすでに存在する場合、または作成に失敗した場合。

### <Badge color="blue" size="lg" shape="rounded">メソッド</Badge> Registry.delete()

```python theme={null}
self
```

Registry を削除します。この操作は元に戻せません。

### <Badge color="blue" size="lg" shape="rounded">メソッド</Badge> Registry.load()

```python theme={null}
self
```

バックエンドから Registry の属性を読み込みます。

### <Badge color="blue" size="lg" shape="rounded">メソッド</Badge> Registry.members()

```python theme={null}
self
```

この Registry の現在のメンバー (Users と Teams) を返します。

### <Badge color="blue" size="lg" shape="rounded">メソッド</Badge> Registry.remove\_members()

```python theme={null}
self, *members: 'User | UserMember | Team | TeamMember | str'
```

この Registry からUsersまたはTeamsを削除します。

<div id="arguments">
  ##### 引数
</div>

<ResponseField name="members" type="User | UserMember | Team | TeamMember | str">
  Registry から削除するUsersまたはTeams。`User` オブジェクト、`Team` オブジェクト、またはそれらの文字列IDを受け付けます。
</ResponseField>

<div id="raises">
  ##### 送出される例外
</div>

* `TypeError`: 引数としてメンバーが1つも渡されなかった場合。
* `ValueError`: ユーザーまたはチームのIDを推定または解析できない場合。

<div id="examples">
  ##### 例
</div>

```python theme={null}
import wandb

api = wandb.Api()

# 既存のレジストリを取得する
registry = api.registry(name="my-registry", organization="my-org")

user1 = api.user(username="some-user")
user2 = api.user(username="other-user")
registry.remove_members(user1, user2)

old_team = api.team(name="old-team")
registry.remove_members(old_team)
```

### <Badge color="blue" size="lg" shape="rounded">メソッド</Badge> Registry.save()

```python theme={null}
self
```

Registry の属性をバックエンドへ保存します。

### <Badge color="blue" size="lg" shape="rounded">メソッド</Badge> Registry.team\_members()

```python theme={null}
self
```

この Registry に現在所属しているTeamsを返します。

### <Badge color="blue" size="lg" shape="rounded">メソッド</Badge> Registry.update\_member()

```python theme={null}
self,
member: 'User | UserMember | Team | TeamMember | str',
role: 'MemberRole | str'
```

このRegistry内のメンバー (ユーザーまたはチーム) のロールを更新します。

<div id="arguments">
  ##### 引数
</div>

<ResponseField name="member" type="User | UserMember | Team | TeamMember | str">
  ロールを更新する対象のユーザーまたはチームです。`User` オブジェクト、`Team` オブジェクト、またはそれらの文字列 ID を受け取ります。
</ResponseField>

<ResponseField name="role" type="MemberRole | str">
  メンバーに割り当てる新しいロールです。次のいずれかを指定できます。

  * "admin"
  * "member"
  * "viewer"
  * "restricted\_viewer" (W\&B サーバーでサポートされる場合)
</ResponseField>

<div id="raises">
  ##### 送出される例外
</div>

* `ValueError`: ユーザーまたはチームの ID を特定できない場合。

<div id="examples">
  ##### 例
</div>

Registry のすべてのユーザーを管理者にする

```python theme={null}
import wandb

api = wandb.Api()

# 既存のRegistryを取得する
registry = api.registry(name="my-registry", organization="my-org")

for member in registry.user_members():
    registry.update_member(member.user, role="admin")
```

### <Badge color="blue" size="lg" shape="rounded">メソッド</Badge> Registry.user\_members()

```python theme={null}
self
```

このRegistryに現在所属しているメンバーUsersを返します。

### <Badge color="blue" size="lg" shape="rounded">メソッド</Badge> Registry.versions()

```python theme={null}
self,
filter: 'dict[str, Any] | None' = None,
order: '_VersionOrder | None' = None,
per_page: 'PositiveInt' = 100,
start: 'str | None' = None
```

このRegistryに属するアーティファクト versionを返します。

<div id="arguments">
  ##### 引数
</div>

<ResponseField name="filter" type="dict[str, Any] | None">
  アーティファクト version のクエリに適用する、省略可能なフィルターのマッピング。
</ResponseField>

<ResponseField name="order" type="_VersionOrder | None">
  結果の並び順を指定する省略可能な string です。`created_at`、`artifact_size`、`linked_at` を指定できます。'+' を接頭辞として付けると昇順 (デフォルト) で並べ替え、'-' を接頭辞として付けると降順で並べ替えます。
</ResponseField>

<ResponseField name="per_page" type="PositiveInt">
  1ページあたりに取得する結果の数です。通常、これを変更する理由はありません。
</ResponseField>

<ResponseField name="start" type="str | None">
  過去のクエリを再開するためのページネーションカーソルで、以前のページネーターの `.cursor` 属性から取得します。
</ResponseField>
